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e've got something to show 
W... that you will have to see 
with your own eyes to believe. 
It's Symantec C++ 7.0. And 
if you're a Macintosh developer, 
you'll want to take a good look. 


VISUAL ARCHITECT. THE 
EASIEST Way To DESIGN A 
MACINTOSH INTERFACE. 


Our new Visual Architect lets 
you visually design and create all 
of your windows, dialogs, bitmaps, 
alerts, controls and menus. Then 
it automatically generates your 
complete Mac application. 


You can test the user interaction 


NEW SYMANTEC G+ 7.0. YOU'D HAVE 
TO BE BLIND TO PROGRAM [MACINTOSH 
WITH ANYTHING ELSE. 





of your Macintosh application 
immediately while in Visual 


tna. are ST IN 2 

Visual Architect simplifies the creation of your 
Macintosh interface so you can focus on the big 
picture: creating killer applications. 


Architect's prototype mode, 





without even having to compile 
your application. 

Completely integrated within 
our THINK Project Manager 
environment, Visual Architect Is 
immediately accessible to you 
every step of the way. Simplifying 
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See pee 


Any way you look at it, Symantec C++ 7.0 
for Macintosh with its Visual Architect is the easiest 
way to design the Macintosh user interface. 


your entire development process 
from design to the final code. 

To help cut your development 
cycle even further, we've also 
included a brand new object 
browser that more efficiently lists, 
examines and modifies all objects 
instantiated during the course of 
your applications development. 

We've also enhanced our 
THINK Class Library 2.0 (TCL 2.0) 
with C++ pointers and memory 
management, new support for 
AppleEvents and scriptable apps, 
exception handling support and 
of course, object-persistence. 


THE PATH TO POWER 
MACINTOSH. 


Our new TCL 2.0 uses universal 
headers, removes all the assembly 











code specific to 68K and It also 





supports Power Macintosh 
procedural pointers. 

So all of your TCL applications 
written in Symantec C++ 7.0 will 
port easily to Power Macintosh 








giving you a head start on your 
Power Macintosh development. 
What's more, we're offering 






you a developers’ pre-production 
release of our Power Macintosh 







Cross Development Kit. It has the 






tools you need to get started on 
creating native Power Macintosh 





applications today, including a copy 
of Apple's Power Macintosh linker 
and debugger. 





It's a way to speed up the 
development of your Macintosh 
applications right now — and be the 
first to move your programs to 
the Power Macintosh platform. 


CALL 1-800-628-4777. 


Ask for ext. 9H22 to upgrade to 
Symantec C++ 7.0 for Macintosh 
today for just $149.95* and get our 
developers’ pre-production release 
of the Power Macintosh Cross 
Development Kit for just $100. 

This offer is not 
available in any retail 
store. So call now. 

And get your 
code ready for 





Power Macintosh. 


‘SYMANTEC. | 


*$499.00 Suggested Retail Price. Power Macintosh Development Kit available only with purchase of or upgrade to Symantec C++ 7.0. For more information in Canada, call |-800-667-866l. 
Symantec, the Symantec logo, Symantec C++, and Visual Architect are trademarks of Symantec Corporation. All other products or brand names are trademarks of their respective holders. 


©1994, Symantec Corporation. All rights reserved. 


ow, create Macintosh applications Eater 

than ever before. With VIP-BASIC, you will 
create a complete, stand-alone Macintosh 
application in an hour or your money back— 
guaranteed! 

VIP-BASIC is absolutely the fastest way 
to create Macintosh applications in BASIC. 
VIP-BASIC’s visual design, its application 


building aids, and its ability to let you modify 
your program code and interface with immediate _ 
feedback, give you a real programming edge. 
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Complete Development System 

Now prototype and develop with just one 
system. VIP-BASIC integrates an application 
framework, resource editors, visual editor with 
automatic flowchart generation, and an 
optimizing interpreter with a source-code 
debugger. Develop applications in standard 
BASIC and use this intelligent, interactive 
programming environment to quickly turn out a 
stand-alone, full-featured Macintosh application. 
No more moving from tool to tool. No more 
dependence on non-standard languages. 


For All Levels of Programmers 
VIP-BASIC offers five levels of support, 


allowing you to program in the way that best 
suits your abilities. At the lowest level, standard 
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Mac Toolbox, VIP-BASIC provides even more 
support. VIP-BASIC Subprograms let you 
program without understanding low-level 
Toolbox calls. The higher-level VIP-BASIC 
Dispatcher and integrated Resource Editors 
provide an application framework, automatically 
setting up your application’s main event loop 
and user interface elements. 


Integrated Interpreter/Debugger 

Check and run your program at any time 
using the integrated interpreter. Track down 
elusive problems with the integrated debugger — 
even set, show, and lock debugging to a specific 
context routine. Also, Monitor mode executes 
and displays your code at reduced speed, showing 
code progression and results at the same time. 
It’s like watching a movie of your application. 


Application Framework 
The VIP-BASIC Dispatcher simplifies 
program development by automating the main 
event loop. It acts as a central controller to 
manage program events by distributing tasks to 
different routines—all without any programming. 


User interface items—menus, dialogs, buttons, 
etc.—are sige tease resource editors 


Editors include ALRT, CNTL, DLOG MBAR, 
MENU, PICT, SIZE, STR, STR#, TEXT, “vers’, 
and WIND. 


Powerful Prewritten Subprograms 
Subprograms for the most frequently used 

features of the Mac interface have been 
prewritten and stored in a palette for instant use. 
With the click of a mouse you can lighten your 
programming workload and speed design and 
coding time by a factor of 10. In fact, you can 
write an entire program without any Toolbox 


calls, just by using VIP-BASIC Subprograms. 


On-Line Macintosh Toolbox Calls 
VIP-BASIC accesses the complete Mac 
Toolbox. A simple command initiates a Toolbox 
call search and displays a prototype for any 
function, structure, or macro. No more rooting 
through multiple volumes of Inside Macintosh. 


Buy VIP-BASIC at a Limited- 
Time Ses Price of $195 With a 
60-Day Money-Back Guarantee! 


VIP- BASIC’s suggested retail price is $295. 
But from now until August 1, 1994, MacTech 
readers can order VIP- BASIC for only $195. Call 
Mainstay to order VIP-BASIC ae 


71 rue des Atrebates 
B-1040 Brussels, Belgium 
32-2/733.97.91 
32-2/732.32.46 fax 


591-A Constitution Avenue 
Camarillo, CA 93012 
(805) 484-9400 

(805) 484-9428 fax 
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How To ComMMUNICATE WITH 


XPLAINCORPORATION 
(the publishers of MacTech Magazine) 





In this electronic age, the art of 
communication has become both 
easier and more complicated. The 
best ways to communicate with us are: 


If you are sending something via the 
postal service, please mail it to 
Xplain Corporation, P.O. Box 250055, 
Los Angeles, CA 90025-9555. 


If you are calling us, our voice 
number is 310/575-4343, and our 
fax is 310/575-0925. 


International readers are invited 
to fax as we do reply via fax 
internationally, but e-mail is best. 


If you are an e-mail user, you can use: 


AppleLink users can reach us at 

the following addresses: 

Orders, Circulation and Customer 
Service: MT.CUSTSVC 

Editorial: MT. EDITORIAL 

Ad Sales: MT.ADSALES 

Programmers Challenge: 
MT.PROGCHAL 

General: MACTECHMAG 


For our AppleLink vendor folder, 
see Third Parties:Third Parties (H-O) 


CompuServe users can reach us at 

the following addresses: 

Orders, Circulation and Customer 
Service: 71333,1063 

Editorial: 71333,1065 

Ad Sales: 71552,172 

Programmers Challenge: 71552,174 

General: 71333,1064 


For our CompuServe vendor folder, 
type “GO MACTECHMAG?” 


Internet users can reach us at the 
following addresses: 
Press Releases: 
pressreleases@xplain.com 
Orders, Circulation and Customer 
Service: custservice@xplain.com 
Editorial: editorial@xplain.com 
Ad Sales; adsales@xplain.com 
Programmers Challenge: 
progchallenge@xplain.com 
Accounting: accounting@xplain.com 
Marketing: marketing@xplain.com 
General: info@xplain.com 


America Online users can reach us 
at the following address: 
Orders, Circulation and Customer 
Service: MT CUSTSVC 
Editorial: MT EDITORS 
Ad Sales: MT ADSALES 
Programmers Challenge: 
MT PRGCHAL 
General: MacTechMag 


For our AOL vendor folder, use 
keyword: MACTECHMAG 


GEnie users can reach us at the 
following address: 
All departments: MACTECHMAG 


If you are submitting a press 
release, please use the Internet 
press release address. 


If you are interested in sending a 
product for review, send it to the 
main address, Attn: Products Editor. 
Only products submitted to this 
address will be eligible for review. 


Finally, if you are interested in 
placing an advertisement, contact 
the main office. 


If you have any questions, feel free to call the main number. 
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By Scott T Boyd, Editor 


[IS IT NEWS YET? 


According to a recent MacWeek article, “Apple undertook an 
organizational spring cleaning last week... Amid all the 
organizational moves, only Apple’s PC and AppleSoft divisions 
were not altered.” 

Is that so? While the general press talks about Apple big 
shots coming and going, developers generally care about the 
people who make Macintosh, and those are the individual 
contributors. Only last week, three of my former coworkers 
from the Apple system software team announced that they 
would be leaving to pursue other interests. That might not be 
big news by itself, but they’re not alone. 

Over the past year, the system software organization has 
lost a steady stream of contributors. I kept a list of those who 
had moved on (it started as a series of tombstones on a 
whiteboard) and handed it off to a friend when I left in early 
January. A couple of weeks later, he left. I knew over fifty 
people on the list when I handed it off, and you’d probably 
recognize many of them, too (e.g. check out p. 48). 

“So what’s the deal?” “Why did you leave?” “But Apple’s 
like Mecca (or Camelot)! How could you leave?” These are 
questions that are nearly impossible to address directly, but they 
usually bring mention that Mecca has seen a number of 
shootings in recent years, and a question, “What do you 
suppose happened to Camelot after Arthur died?” 

Now that’s pretty gloomy stuff. You may have noticed, my 
livelihood is directly tied to Apple’s success, so I’m not 
predicting any major catastrophe. 

Apple has long been a strangely successful company. For 
as long as I can remember, Apple has been making some kind 
of major mistake. Started by two kids in a garage. Too fun- 
loving. Apple ///. Twiggy drives. Wrong processor. Too cute. 
Closed architecture. Not PC compatible. Not enough models. 
Not licensing system software or the ROMs. Portable. Buying 
DRAM on the spot market. Too expensive. Too long 
development cycles. Too many models. And through it all, 
Apple prospers. 

Why? As best as I can figure, Apple thrives on chaos. For 
many people, five years of Apple chaos seems to be about the 
right number, after which they seek out some dream that spent 
five years in the making. Five years of chaos seems to heighten 
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an awareness of how improbable and inconsistent it all is. On 
the other hand, perhaps the belief in the possibilities, itself 
made possible by the lack of experience to the contrary, brings 
about the impossible. So, as the weary faces leave, fresh faces 
show up almost daily. As the old hands reminisce about major 
snafus and interminable politics, the new hands set out, 
determined to make their mark on Macintosh. The steady 
stream of new technologies stands in stark contrast to the 
steady stream of individual contributors moving on. 


WHITHER DYNAMIC LANGUAGES? OR IS IT WITHER? 


There’s been a flurry of activity recently on the net about 
Macintosh Common Lisp (MCL). A rather large number of 
people have complained that Apple is not porting MCL to the 
Power Macintosh. That’s particularly notable, because MCL 
would clearly benefit from the performance of the new 
machines, and MCL is a power-hungry environment. 

Some speculated that Apple might be discontinuing or 
dropping MCL. Apple’s response? MCL’s going on life support 
while they look for a third party to pick it up. 

So why the furor? According to a few postings, MCL offers 
one of the very best Common Lisp environments on any 
machine. They also noted that they would begin shopping for 
a new Common Lisp right away, no matter that it would 
certainly be on a different platform. This sets MCL users apart 
from the “normal” Macintosh developer. While MCL users show 
clear signs of the normal rabid devotion, it’s a devotion to the 
software and not the Macintosh itself. 

And what’s so great about the software? That’s simple. It’s 
a dynamic programming language/environment. In many ways, 
it’s light-years ahead of the more “traditional” 
edit/compile/link/execute/debug environments. Sure it’s 
resource hungry. So what? The resources are getting bigger 
and more powerful all the time, and getting cheaper, too. 

As for the future of dynamic languages from Apple, our 
sources say that WWDC might be a good place to be to hear 
some news. 


FOOD FOR THOUGHT 


“The best line of code you can write is the line of code you 
never had to write.” — Stephen P. Jobs 
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Don’t even think about using a 






Relational Database System ! 
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Use the POET Object Database for C+ + 


C++ and class libraries have made the GUI development much 
easier. After all, it is only logical that more and more developers 
think in objects. But object orientation shouldn't end at the user 
interface programming level. 


The Problem: Without POET, aC++ programmer must use flat 
files or a RDBMS to store objects. He has to write code to over- 
come the mismatch between the application and the database 
model. This leads to design restrictions, performance penalties and 
more code to write and maintain. 


The Solution: POET operates at the object level, it speeds up the 
development process and provides greater performance. Further- 
more, the developer can simply take the object-oriented applica- 
tion design in C++ and map it | to | into the database. Without 
any compromise at all! 
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Comparing Object Oriented and 
Relational Design Methodologies 










B Feature POET ODBMS _ Relational RDBMS 





Break Objects 


Storing Objects As Objects 
into Tables 









Database Model User Application Separate Database 
Model ' Model Required 





C++ Integration Total Poor 


Database At Object Level Must Write Code 
Operations 


Productivity Increased Reduced 


Complex Object Excellent Poor 
Performance 





Full featured 
database: 

POET provides 
complete support 
for Encapsulation, Inheritance, Polymorphism and Containers as 








well as queries, object locking, and transaction handling . 


True cross platform support: Complete interoperability makes 
the development of network enabled applications a breeze. POET 
supports Macintosh, Power Macintosh, Windows 3.1, Windows 
NT, Win32s, Windows for Workgroups, Novell Netware (NLM), 
SUN, AIX, HP-UX, SGI, SCO, OS/2 and NeXTStep. 


Call 1-800-950-8845 
POET 
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POET Software Corporation, 4633 Old Ironsides Dr., Suite 110, Santa Clara, CA 95054, Tel.: (408) 970-4640 Fax: (408) 970-4630 
United Kingdom (Silicon River) +44 81-316-7777, Germany (POET Software) +49 40-60-99-00, Australia (Microway) +61-3-580-1333, France (LCI) +33-1-34-65-7777 
Netherlands (Protools Software) +31 20 645 5023, Sweden (Duke Systems) +46 8 703 2781 
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Cofforate Member, Corporate & 

_ Individual Sponsor: 

These membership categories offer higher 
recognition and additional discounts. 
Contact the Association office for details. 


Software Frameworks Association 
10062 Miller Ave., #202-B 
Cupertino, CA 95014 

Voice: 408 253 2765 

Fax: 408 253 2767 

Applelink: FRAMEWORKS 

Internet: info@frameworks.org 


Software Frameworks Association publishes 
the following bimonthly magazines: 


FRAMEWORKS 
The journal for software developers 
using object technology 


DOUBLETAP 
For PDA software and content developers 


MFCJOURNAL 
For developers using Microsoft eouniation Classes 
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New for PowerPC Macintosh 


Absoft's NEW E77 for Apple PowerMacisa powerful, complete program- 





ming solution. It combines Absoft's globally optimizing native 


FORTRAN compiler, native linker, Fx debugger, and Apple's proven 








MPW development environment. 
Return 
Continue 
Step Into 
Step Over 


Designed for the needs of profes- 


sional FORTRAN developers, F77 offers a 
variety of cross-platform compatibility op- 
tions that make it the best choice for devel- 
oping or porting code with the new 
PowerMac. 

F77 is open and flexible. It is link 
compatible with Absoft's forthcoming na- 
tive C/C++, 68K MPW C and Pascal, and 
Apple'sC/C++ forPowerMac.Itisalso100% ~~ | 
compatible with Absoft MacFortran II for 68K Macintosh, and other 
Absoft F77 compilers for DOS, WindowsNT, and UNIX. ! 

Fx, Absoft's multi-language source level debugger, brings unprec- 
edented functionality to Macintosh FORTRAN developers. Fxis the only 
Macintosh debugging tool that supports the full syntax of FORTRAN 77 
and automatically recognizes intermixed C, FORTRAN, and assembly 
code. A complete Macintosh interface featuring multiple dynamic win- 


dows and full menu driven commands with 9-key equivalents make Fx 


both powerful and easy to learn and use. 


FORTRAN 77 
Development 
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Absoft F77 Development 














Toolkit for Apple PowerMac is 
available NOW: 
Retail Price $695.00 
Upgrades from 
¢MacFortran 
¢ MacFortran/020 
¢MacFortran Il 
are also available. 
Contact Absoft for upgrade 


pricing information. 
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Fx debugger supports the complete 
syntax of the FORTRAN 77 language. 





development ihe and languages 
2781 Bond Street 

Rochester Hills, MI 48309 

Tel: (810) 853-0050 

Fax: (810) 853-0108 

AppleLink: absoft 

email: fortran@absoft.com 


All trademarks and brand names are property of their respective holders. © Absoft, 1994 





Bringing software into the world is a little 
like bringing up children. You always know 
where they start, but you seldom know 
where they’ll end up. These days, with 
illegal use of software so common, 
concerned developers have good reason to 
worry about the products of their labor. 
That’s where MacHASP comes in. 





Like a responsible babysitter, MacHASP 
accompanies your software wherever it goes. 
With MacHASP there, your software won’t 
run out of control. Without MacHASP. in 
fact, your software won’t run at all. 


It's Midnight. 


Do You Know Where 


For developers, MacHASP provides the 
highest level of security and reliability. 

For legitimate users, MacHASP is a friendly 
and transparent solution. Once connected, 
they won’t even feel it’s there. 


And if your child wants to play with 

its friends, a single Net-MacHASP lets it 
run free around a local area network. But 
always under your supervision and control. 


The HASP family of software protection 
products. Because software developers 
have enough sleepless nights already, 


Call now for your MacHASP evaluation kit. 


LADDI 


The Professional's Choice 


North Aladdin Software Security Inc 
America The Empire State Building 
350 Fifth Avenue, Suite 7204 
New York, NY 10118, USA 
Tel: (800) 223 4277 
212-564 5678 
Fax: 212-564 3377 


International Aladdin Knowledge Systems Ltd. 
Office 15 Beit Oved St., Tel Aviv, Israel 

P.O.Box 11141, Tel Aviv 61110 

Tel: 972-3-5375795 

Fax: 972-3-5375796 

AppleLink: ALADDIN.KNOW 


PowerMAC Comp atible! France Aladdin France SA 





Tel: 33 1 40 85 98 85 
Fax: 33 1 41 21 90 56 


© Aladdin Knowledge Systems Ltd. 1985-1994 (4.94) PowerPC is a trademark of Motorola. Macintosh is a trademark of Apple Inc. 
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By Dave Mark, MacTech Magazine Regular Contributing Author 





ROLLING YOUR OWN MDEFs 


Help your menus get the picture... 


This month’s program is a departure from our traditional 
applications. Though we do build an application, it only serves as a 
tester for our MENU definition procedure. When your application 
includes a menu bar made up of a series of MENU resources, you'll 
normally take advantage of the standard menu definition procedure 
(better known as an MDEF) provided by the Menu Manager. 

Every time you call MenuSelect() (in response to a 
command-key equivalent or to a click in the menu bar), the Menu 
Manager takes over, drawing and erasing menus in response to 
your mouse clicks. Every menu specifies an MDEF resource (we'll 
get to that when we create the tester’s MENU resources later in the 
column). Each time a menu is drawn, the MDEF specified by the 
menu is called to draw the menu’s contents and to highlight the 
appropriate item as the mouse moves. 

This month, we’re going to write our own MDEF, compile it 
into an MDEF resource, then write a test program to test the 
MDEF. Rather than rewrite the standard MDEF, our MDEF will 
create a menu of PICT resources, as opposed to text. 

This MDEF is actually a rewrite of the MDEF from Volume II 
of the Mac Primer. Besides being a little long in the tooth (e., 
old and funky), the original broke some Toolbox rules that 
caused the Thought Police to pay me a visit... 


CREATING THE MDEF PROJECT 


Create a folder called MDEF Files in your Development 
folder. Launch THINK C and create a new project named 
MDEE.x. Add MactTraps to the project. Next, create a new 
source code file, save it as MDEF.c, and add it to the project. 

Type in this source code in the MDEF .c window: 


#fdefine kTopMargin 1 
define kLeftMargin iz 


void DoSizeMessage( MenuHandle menu, Rect *menuRectPtr ); 
void DoDrawMessage( MenuHandle menu, Rect *menuRectPtr de 
void DoChooseMessage( MenuHandle menu, Rect *menuRectPtr, 
Point hitPt, short *whichItemPtr ); 
void InvertItem( short itemNumber, short itemHeight, 
Rect *menuRectPtr ); 
void DrawCenteredPict( PicHandle pic, Rect *rectPtr ); 
void CalcitemHeightAndWidth( short basePICTid, short numPICTs, 
short *widthPtr, short *heightPtr ); 
void GetNumPICTs( MenuHandle menu, short *baseIDPtr, 
short *numPICTsPtr ); 
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main 


pascal void main( short message, 
MenuHandle menu, 
Rect *menuRectPtr, 
Point hitPt, 
short *whichItemPtr ) 
{ 
switch( message ) 
{ 
case mDrawMsg: 
DoDrawMessage( menu, menuRectPtr }3 
break; 
case mChooseMsg: 
DoChooseMessage( menu,menuRectPtr,hitPt,whichItemPtr Ve 
break; 
case mSizeMsg: 
DoSizeMessage( menu, menuRectPtr ); 
break; 
} 
} 


a en Ey POE 


DoSizeMessage 


void DoSizeMessage( MenuHandle menu, 
Rect *menuRectPtr ) 


{ 
short basePICTid, numPICTs, maxPICTWidth, maxPICTHeight; 


GetNumPICTs( menu, &basePICTid, &numPICTs ); 
CalcitemHeightAndWidth( basePICTid, numPICTs, &maxPICTWidth, 
&maxPICTHeight ); 


(**menu) .menuWidth = maxPICTWidth + 2 * kLeftMargin; 
(**menu) .menuHeight = (maxPICTHeight + kTopMargin*2) * numPICTs; 
} 


an ee ar Sc —SaEERE VSS 


DoDrawMessage 


void DoDrawMessage( MenuHandle menu, 
Rect *menuRectPtr ) 


{ 


short basePICTid, numPICTs, maxPICTWidth, 
maxPICTHeight, itemHeight, i; 
Rect r, tempRect; 


PicHandle pic; 


GetNumPICTs( menu, &basePICTid, &numPICTs ); 
CalcitemHeightAndWidth( basePICTid, numPICTs, 
&maxPICTWidth, &maxPICTHeight ):; 


itemHeight = maxPICTHeight + kTopMargin * 2; 


.top = menuRectPtr->top + kTopMargin; 
left = menuRectPtr->left + kLeftMargin; 
-bottom = r.top + maxPICTHeight; 

-right = r.left + maxPICTWidth; 


iy ee eS 


for ( i=0; i<numPICTs; i++ ) 

: 
pic = GetPicture( basePICTid + i ); 
DrawCenteredPict( pic, &r ); 


OffsetRect( &r, 0, itemHeight ); 
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} 
} 
DoChooseMessage 
void DoChooseMessage( MenuHandle menu, 
Rect *menuRectPtr, 
Point hitPt, 
short *whichItemPtr ) 


SS 


short basePICTid, selectedItem, numPICTs, 
maxPICTWidth, maxPICTHeight, itemHeight; 
Rect r: 


GetNumPICTs( menu, &basePICTid, &numPICTs ); 
CalcitemHeightAndWidth( basePICTid, numPICTs, 
&maxPICTWidth, &maxPICTHeight ); 


itemHeight = (2 * kTopMargin) + maxPICTHeight; 


if ( PtInRect( hitPt, menuRectPtr ) ) 
{ 
SelectedItem = ( (hitPt.v - menuRectPtr->top) / 
itemHeight ) + 1; 


if ((*whichItemPtr > 0) && (*whichItemPtr != selectedItem) ) 
{ 


InvertItem( *whichItemPtr, itemHeight, menuRectPtr ); 
} 


if ( *whichItemPtr != selectedItem ) 
{ 
*whichItemPtr = selectedItem; 
InvertItem( *whichItemPtr, itemHeight, menuRectPtr ):; 


} 
else if ( *whichItemPtr > 0 ) 
{ 
InvertItem( *whichItemPtr, itemHeight, menuRectPtr ); 
*whichItemPtr = 0; 
Sj 
} 
InvertItem 
void InvertItem( short itemNumber, 
short itemHeight, 
Rect *menuRectPtr ) 
{ 
Rect e: 


r = *menuRectPtr;: 


r.top += ( (itemNumber-1) * itemHeight ); 
r.bottom = r.top + itemHeight; 


InvertRect( &r ); 
} 
DrawCenteredPict 
void DrawCenteredPict( PicHandle pic, 
Rect *rectPtr ) 
{ 
Rect pictRect; 


pictRect = (**pic).picFrame; 


OffsetRect( &pictRect, rectPtr->left - pictRect.left, 
rectPtr->top - pictRect.top); 

OffsetRect( &pictRect,(rectPtr->right - pictRect.right) /2, 
(rectPtr->bottom - pictRect.bottom)/2); 


DrawPicture( pic, &pictRect ); 
} 
see CalcitemHeightAndWidth 
void CalcitemHeightAndWidth( short basePICTid, 
short numPICTs, 
short *widthPtr, 
short *heightPtr ) 
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PicHandle pic; 


*widthPtr = 0; 
*heightPtr = 0; 


for ( i=0; i<numPICTs; i++ ) 

{ 
pic = GetPicture( basePICTid + i ); 
r= (**pic).picFrame; 


if ( r.bottom - r.top > *heightPtr ) 
"heigntrtt =r botiem - r.top: 


if ( r.right - r.left > *widthPtr ) 
*widthPtr = r.right - r.left; 
} 
} 


GetNumPICTs 


void GetNumPICTs( MenuHandle menu, 
short *baselIDPtr, 
short *numPICTsPtr ) 


Handle longHandle; 
long retrievedLong; 
short menulID; 


menuID = (**menu) .menuID; 
longHandle = GetResource( 'long', menulID ); 
retrievedLong = (*((long *) (*longHandle))); 


*baseIDPtr = HiWord( retrievedLong ); 
*numPICTsPtr = LoWord( retrievedLong ); 


Save your source code. Next, select Set Project Type... 
from the Project menu. When the dialog appears, click on the 
Code Resource radio button. Now make your dialog box 
look like the one in Figure 1. Be sure to check every single field! 


() Application 

© Desk Accessory 
() Device Driver 
@ Code Resource 


File Type 


Creator 


Name |PICT 


Type 


[] Custom Header 


Figure 1. The Set Project Type... dialog box. 





The File Type and Creator fields will make your MDEF 
file look like a ResEdit document. That way, when you double- 
click on the file MDEF.rsrc (which we're about to create) 
you'll automatically launch ResEdit. 

Why do this? Well, if we create the MDEF resource in a file, 


JUNE 1994 





we'll eventually want to copy the MDEF into the resource file 
(or application) that will use the MDEF. We'll most likely do this 
in ResEdit. . 

Now select Build Code Resource... from the Project 
menu. You'll be prompted to name the file the MDEF resource 
will be copied to. There are two approaches you can use. If you 
plan on using this resource in more than one application, you 
should save it as its own resource file. That’s what we'll do. 
Enter the name MDEF.1.rsrc and press the Save button. 

The second approach we could have taken would be to 
click on the Merge checkbox, then entering the name of the 
resource file of the application that will be using the MDEF. If 
you do this, the MDEF resource will be copied into the 
application’s resource file, which is really what you want. We'll 
do the same thing by hand. 





66 Click your mouse on the 
Pictures menu. 
A menu should appear 
with your five PICTs in it. 9 





CREATING THE TESTER RESOURCES 


Now that your MDEF is complete, you'll build an 
application to test the sucker. We'll start by building the project 
resources. Start ResEdit and create a new file in the MDEF 
Files folder called Tester.m1.rsrc. Now open the file 
MDEF.n.rsre, click on the MDEF icon, and select Copy from 
the Edit menu. Now click on the Tester.1.rsre window 
and select Paste from the Edit menu. The MDEF icon should 
appear in the Tester.n.rsrc window. When you double- 
click on the MDEF icon, you should see a single MDEF with an 
ID of 128. So far, so good. 

Next, create a WIND resource with an ID of 128, a top of 
40, Left of 2, Height of 160, and Width of 200. Click on the 
second icon from the left for the window type. Make the 
window not visible. 

Next, create an MBAR resource (with ID 128) with four 
menus in it, numbered 128, 129, 130, and 131. 

Next, create four MENU resources using the pictures in 
Figure 2 as a guide. Note that MENU 131 has a title (Pictures) 
but no items. 
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Figure 2. The four MENU resources. 


Now comes a critical step. Open up the MENU editor to edit 
MENU 131. Select Edit Menu & MDEF ID... from the MENU 
menu. A dialog box will appear allowing you to set the MENU 
and MDEF resource IDs for this MENU. Change the MDEF ID 
from 0 to 128. Leave the MENU ID as is. 

Be sure you change the MDEF id. If you don’t, the program 
will not work! 

Next, you'll create a custom resource that will tell the 
MDEF the resource ID of the first PICT to display, as well as 
the number of PICTs to display in the menu. Close all the 
windows till you are back in the main Tester.m.rsrce 
window. Now select Create New Resource from the 
Resource menu. When prompted for a resource type, enter 
the four characters long. Since ResEdit doesn’t have a ‘long’ 
template, it will throw you into the hex/ASCII editor. Use the 
hex side and enter the hex number 00800005. For a peek at 
mine, check out Figure 3. 


ooo000 
oo0008 
0000 10 
000018 
o00020 
oo00028 
000030 
o00038 
000040 
000048 
000050 
000058 
oo0060 
OO006S 


oso o005 





Figure 3. The Long resource. 
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A 
The Macintosh 


The ADB port is the best place to attach a 


hardware key to a Mac and PowerPC, and not 
just because Apple says so. Working with the 
ADB port insures that the key will be compat- 


ible with all future Apple machines, and that 
many external devices can coexist. But sim- 
ply plugging into the port is not enough - one 
must master the ADB protocol to take advan- 
tage of these benefits. Most other key manu- 
facturers have 
ported over their 
Mac key from a 
PC key, and in 
the process little 
understanding of 
the ADB came 
with it. Here at 
MicroMacro we 
have been developing Mac applications as a 
seed development house since 1984; and not 
only do we have a license from Apple to use 
the ADB port, but we have made 
MicroGuard 100% ADB savwvy. This insures 
that there will be no clashes between 
MicroGuard and other ADB devices, and that 
MicroGuard will be compatible will all future 
Apple hardware. In fact, MicroGuard can be 
daisy chained with up to 15 other ADB 
devices on the Mac and PowerPC. 
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B 
Software Security 


Simply placing an ADB key with limited fun- 
tionality on your application is not the goal, as 
some key manufacturers would like you to 
believe. This ‘cosmetic’ approach may in fact 
deter some piracy (similar to the deterrence 
provided by the alarm sticker on a car) but it 
is not protection. At MicroMacro our design 
team leaders brought to the task over 30 years 
of experience in the most sophisticated areas 
of electronic security. This, 
coupled with our Mac 


us to create a key that 
utilizes the most advanced 
and powerful security regimens 
available in software security. And, to insure 
that there would be no weak link in our pro- 
tection, we custom designed our own ASIC 
chip — specifically for MicroGuard to insure 
that all of our protection is securely housed 
inside the key, and not vulnerably placed in 
external software routines. Be wary of prod- 
ucts using non custom ASIC chips; their pro- 
tection is largely dependant on easily cracked 
software routines since their off the shelf chips 
lack the functionality required for the job. 





lo receive more information including price lists, to order a Developer's Kit, or 
to receive a free CD ROM about MicroGuard, please contact us at our inter- 
national AppleLink Address MICROGUARD or contact one of our regional 
offices for the name of your local distributor: 


The ABC’s of 
ADB Software Copy Protection 


Producing a truly reliable copy protection key with extr: 
ordinary performance is not impossible. 
understand the ABC’s of the subject very well. 
MicroGuard we built ‘perfect protection. We know our ABC’ 





expertise, allowed 
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Your Business 


Being a Mac ADB and security expert is no 
the end of the story. You have a business to 
run, and we understand that quite well. 
Therefore we built MicroGuard with you i 
mind. MicroGuard is shipped ‘generic’ to 
you; you install all your own passwords and 
controlling parameters into MicroGuard. 
This means that if you are shipping more t 
one protected application, you will have no 
inventory control problems, and there are 
delivery delays caused 
a need to custo 
ize your keys; 
will ship your 
new supplies of 
MicroGuard immediately 
upon our receipt of your order. You can eve 
protect every application you ship with its 
own uniquely customized MicroGuard. All 
this, coupled with our surprisingly low price 
and our very fast, friendly and sophisticated 
support center, has made MicroGuard the kd 
of choice for many of the largest Mac develo] 
ers world wide. Contact us and see why so 
many have moved to MicroGuard. 


ViICRC@SUARD' 


A Division of MicroMacro, Ltd. 





MicroGuard USA: 
Tel: 303-320-1628 
Fax: 303-320-1599 
ALink: M.GUARD 






International: 
Tel: 972-2-868-180 
Fax: 97 2-2-868-126 
ALink: IT0092 


There are no tricks in this business - just good work. 


MicroGuard - The Leader 
















































Corie Monin PowerPlant. 

ToolServer, SourceServer and other 
developer utilities from Apple 

Development Products. It’s all here. 


“Without the Metrowerks PowerPC 


We will not | 


Metrowerks CodeWarrior. ae 
The only native one 3 
environment for the Power — | 
Macintosh is here. : 


BRONZE $199 ~—_ compiler it would be virtually impossible 
For 68K Macintosh Sat to develop Adobe Illustrator for the 
SILVER | $299 ~ = Macintosh on the PowerPC.” 

For Power Macintosh Ben Melton 

GOLD : $399 Software Engineering Leader 

ce Power & ARE Bis ich © S _ ~- Adobe Illustrator for Power Macintosh 


Requires CD-ROM drive; System 7.1; 8 megs of RAM; | Lr | Adobe Systems Inc. 


Motorola 68020 or higher or PowerPC 601. 
Metrowerks 


CodeWarrior 


A new way to buy 
Metrowerks CodeWarrior 
delivers 3 times a year. 

With your purchase of DR/2, 
you will receive DR/3 
Metrowerks (which includes Metrowerks 
CodeWarrior Na OF A\\\\ CodeWarrior Version 1.0) in 
isascreamer saline ANY May 1994, DR/4 in August 1994 
Sil VRS and DR/5 in January 1995. 

“Mac developers have been 

waiting a long time for an 
environment like Metrowerks 


CodeWarrior.” 
Stanley Crane 
General Manager R&D 
cc: Mail Division 
Lotus Development Corp. 


Then, 
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Experience RISC technology. ™~ 
Compile 200,000 lines per minute - L ; 
on the Power Macintosh 8100. — : 


“Great company, fast oe 
how can you beat that?” 


Lee Richardson | 
Development Manager, MacWrite 
Claris Corporation 


Metrowerks oe 
CodeWarrior is awesome. _ 
Native C++ and C compilers forthe Power 
Macintosh. Native C++, C and Pascal heen. a 
for the 68K Macintosh. 68K Macintosh- hosted — 
PowerPC compilers. Power Macintosh and 
68K Macintosh source-level debuggers. Anew _ 
Power Macintosh and 68K Macintosh application 


ma “Call MacTech | 
MailOrder” 


310-575-4343 
Fax: 310-575-0925 
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metrowerks 











Next, select Get Resource Info from the Resource 
menu to change the resource ID to 131. You must make this 
change, so the MDEF will associate this resource with MENU 131. 

The first two bytes of the long resource tell the MDEF to 
start off with PICT 128 (in hex, that’s 0080) and to use 5 PICT 
resources in a row (128, 129, 130, 131, and 132). Oh, by the way, 
I called this resource long because it is always 4 bytes in length. 

Once you’ve changed the long resource ID to 131 (you 
did do that, didn’t you?) you are ready to create the PICT 
resources. Create five of them, being sure that they are 
numbered from 128 to 132. Color is fine. For best results, you 
might want to keep all of them around the size of an icon. My 
five are shown in Figure 4. 





Figure 4. My five PICTs. 


Save your resource file and quit ResEdit. 


CREATING THE TESTER PROJECT 


In THINK C, create a new project in the MDEF Files 
folder called Tester.n. Add MacTraps to the project. Create 
a new source code file named Tester.c and add it to the 
project. Here’s the source code: 


#tdefine kWindowResID 128 

#tdefine kMBARResID 128 

#fdefine kNULLStorage OL 

#define kMoveToFront (WindowPtr)-1L 


#fdefine kSleep 60L 
#fdefine mApple 128 
#define iAbout 1 
define mFile 129 
define iQuit 1 
#fdefine mPICT Ei 
/* Globals */ 

Boolean gDone; 


short gCurPICTid; 


/* Functions */ 
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void ToolboxInit( void ); 

void MenuBarInit( void ); 

void WindowInit( void ); 

void EventLoop( void ); 

void DoEvent( EventRecord *eventPtr ); 

void HandleMouseDown( EventRecord *eventPtr ); 
void HandleMenuChoice( long menuChoice ); 

void HandleAppleChoice( short item ); 

void HandleFileChoice( short item ); 

void HandlePICTChoice( short item ); 

void DoUpdate( WindowPtr window ); 

void DrawPictInWindow( PicHandle pic, WindowPtr window ); 
short GetBasePICTid( short menulID ); 


main 
void main( void ) 
{ 
ToolboxInit(); 
MenuBarInit(); 


WindowInit () 
gCurPICTid = GetBasePICTid( mPICT ); 


EventLoop(); 
} 


ToolboxInit 


void ToolboxInit( void ) 

{ 
InitGraf( &thePort ); 
InitFonts(); 
InitWindows(); 
InitMenus(); 
TEInit(); 
InitDialogs( NULL ); 
InitCursor(); 


} 


_—_— —.snm—O™_—"Y\— 





MenuBarlnit 
void MenuBarInit( void ) 
Handle menuBar; 
MenuHandle menu; 
menuBar = GetNewMBar( kMBARResID ); 
SetMenuBar( menuBar ); 
menu = GetMHandle( mApple ); 
AddResMenu( menu, 'DRVR' ); 
DrawMenuBar(); 
} 
Windowlnit 


void WindowInit( void ) 
WindowPtr window; 
window = GetNewWindow( kWindowResID,kNULLStorage, kMoveToFront) ; 
: ( window == NULL ) 


SysBeep( 20 ); /* Couldn't load WIND */ 


ExitToShell(); 
} 


SetPort( window ); 
ShowWindow( window ); 





EventLoop 


void EventLoop( void ) 


EventRecord event; 
gDone = false; 


while ( gDone == false ) 
{ 
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if ( WaitNextEvent( everyEvent, &event, kSleep, nil ) ) 
DoEvent( &event ); 
} : 
} 


SC —————————————————————————————— ——————— 


DoEvent 


void DoEvent( EventRecord *eventPtr ) 
{ 
char theChar; 


switch ( eventPtr->what ) 
{ 
case mouseDown: 
HandleMouseDown( eventPtr ); 
break; 
case keyDown: 
case autoKey: 
theChar = eventPtr->message & charCodeMask; 
if ( (eventPtr->modifiers & cmdKey) != 0 ) 
HandleMenuChoice( MenuKey( theChar ) ); 
break; 
case updateEvt: 
DoUpdate( (WindowPtr)eventPtr->message ); 
break; 
} 
} 


Bee) ee Se cei Ls sasethdesnemnietainedipsenssommaibieiadeiaebtenearaste’ 
HandleMouseDown 


void HandleMouseDown( EventRecord *eventPtr ) 


{ 


WindowPtr window; 
short thePart; 
long menuChoice; 


thePart = FindWindow( eventPtr->where, &window ); 
switch ( thePart ) 
{ 
case inMenuBar: 
menuChoice = MenuSelect( eventPtr->where ); 
HandleMenuChoice( menuChoice ); 
break; 
case inSysWindow: 
SystemClick( eventPtr, window ); 
break; 
case inDrag : 
DragWindow( window, eventPtr->where, &(screenBits.bounds) ) ; 
break; 
} 
} 
SETS CSE IES S11 SPO resent sn 
HandleMenuChoice 
void HandleMenuChoice( long menuChoice ) 
{ ; 
short menu; 
short item; 


if ( menuChoice != 0 ) 


menu = HiWord( menuChoice ); 
item = LoWord( menuChoice ); 


switch ( menu ) 
{ 
case mApple: 
HandleAppleChoice( item ); 
break; 
case mFile: 
HandleFileChoice( item ); 
break; 
case mPICT: 
HandlePICTChoice( item ); 
break; 
} ; 
HiliteMenu( 0 ); 
} 


} 


0 ERR MAIO ie oT MRR eV rT Cn ie ASO VS eo re DIC see eer 
HandleAppleChoice 


void HandleAppleChoice( short item ) 
{ 
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MenuHandle appleMenu; 
Str255  accName; 
short accNumber; 


switch ( item ) 
{ 
case iAbout: 
SysBeep( 20 ); 
break; 
default: 
appleMenu = GetMHandle( mApple ); 
GetItem( appleMenu, item, accName ); 
accNumber = OpenDeskAcc( accName ) ; 
break; 
} 
} 


Se a bine eptionntinelsntpecilingintenstniiaiaceneren 
HandleFileChoice 


void HandleFileChoice( short item ) 
{ 
switch ( item ) 
{ 
case iQuit : 
gDone = true; 
break; 
} 
} 


cee ea aa ci i etter eelbtibeiieasesisbiisinse 
HandlePICTChoice 


void HandlePICTChoice( short item ) 
{ 

WindowPtr window; 

window = FrontWindow() ; 


EraseRect( &window->portRect ) 
InvalRect( &window->portRect ) 


gCurPICTid = GetBasePICTid( mPICT ) + item - I; 
} 


a eens aerecenemimeaianen 
3 ~~~ DoUpdate 


void DoUpdate( WindowPtr window ) 
{ 


PicHandle pic; 

BeginUpdate( window ); 

pic = GetPicture( gCurPICTid ); 
- ( pic == NULL ) 


SysBeep( 20 ); /* Couldn't load PICT */ 
ExitToShell(); 
} 


DrawPictInWindow( pic, FrontWindow() ); 


EndUpdate( window ); 


eer nnilitisamalinimnemeseeesesisnneentne 
DrawPictInWindow 


void DrawPictInWindow( PicHandle pic, 
WindowPtr window ) 


{ 
Rect pictRect, windRect; 


pictRect = (**pic).picFrame; 

windRect = window->portRect:; 

OffsetRect (&pictRect, windRect.left - pictRect.left, 
windRect.top - pictRect.top) ; 


OffsetRect (&pictRect, (windRect.right - pictRect.right)/2, 
(windRect.bottom - pictRect.bottom) /2) ; 


DrawPicture( pic, &pictRect ); 
} 


isa ladiesnpuepeineioreniberboneiteatsheentnameseeiiett 
GetBasePICTid 
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Wi ime Our Software Publishing 
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_ Let's face it. You could use a little time 
f 7 away from the office. All you have to 
do is make Digital your software 
publishing partner. We have state-of- 
the-art ISO 9000 manufacturing 

/ facilities around the world. We’re 
equipped to handle virtually any 
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DON'T GAMBLE with other CASE support 
on your next Object-Oriented software project! ’ 


Your odds without ICONIX PowerTools™ 


20 to 1 with tools that claim to be O-O but are really structured tools in disguise... 
25 to 1 with CASE vendors that don't offer O-O methodology training... 

40 to 1 with single-method tools that support a limited portion of the lifecycle... 
50 to 1 with single-user (toy) tools that don't support server-based development... 
100 to 1 with hard-to-use tools that take a team to make it work... 

200 to 1 just hack the code! Don't bother with this methodology and CASE stuff. 


Beat the odds with ICONIX PowerTools™ 


ICONIX PowerTools supports virtually all major OOA and OOD methods. 


ICONIX provides training for methods, tools and languages including guidelines 
for choosing the best methods for your project and details of individual methods. 


ICONIX PowerTools has full-lifecycle capabilities, including Class, Object, Use- 
Case, State, Process and Module Architecture Diagrams, Language Sensitive Editors 
for C++, Smalltalk, SQL, Ada and others, and Integrated Requirements Traceability. 


ICONIX PowerTools are multi-user tools that support projects of any size. 
ICONIX PowerTools features "standard Mac" ease-of-use. 






























































Your best bet is on ICONIX PowerTools” 
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We've been providing affordable, industrial-strength, easy-to-use CASE products on the Macintosh since 1985, and have been leading the way in Object-Oriented 


methods since 1988. Call us today at (370) 458-0092 and find out why the smart money is on ICONIX! O 


ICONIX Software Engineering, Inc. « 2800 28th St. Suite 320 « Santa Monica, CA 90405 + FAX (310) 396-3454 « Applelink: ICONIX Leadership in Object Technology™ 
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short GetBasePICTid( short menulID ) 
{ 

Handle longHandle; 

long retrievedLong; 





Pictures 


longHandle = GetResource( 'long', menuID a 
retrievedLong = (*((long *) (*longHandle))); 


return( HiWord( retrievedLong ) ); 


Once the code is typed in, save your changes and run this 


puppy. 


RUNNING THE MDEF TESTER 
When you run your application, the first thing you should 
see is a window with PICT 128 centered in it. Now, for the big 
moment. Drumroll, please! Click your mouse on the Pictures 
menu. A menu should appear with your five PICTs in it. Select 


a picture. The selected picture should appear in the window. TILL NEXT MONTH 
Figure 5 shows my menu, with Clarus the Dog-Cow selected. 
Moof! Next month, we'll walk through the code and talk about 
: code resources in general. Till then, Daniel and I will be busy 
putting together his new swing set. Later... 
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Figure 5. My Pictures menu, with the second picture selected. 








INSIDE INFORMATION 





By Chris Espinosa, Apple Computer, Inc., MacTech Magazine Regular Contributing Author 





THE DIFFERENCE THAT MAKES A DIFFERENCE 





What’s valuable depends on your perspective. Will that be changing soon? 


Nick Negroponte of the MIT Media Lab defines information as 
“a difference that makes a difference.” On Usenet, you hear 
about this as the “signal-to-noise ratio,” that is, the kernels of 
useful wheat in the general chaff of questions, misinformations, 
rumors, and flames. In most other circumstances, though, 
information in digital form makes a real difference — and this is 
most true in developing software. 

Every bit of your application makes a difference. At the 
basic level, each bit has to be a non- 
buggy bit (as opposed to a buggy bit) 
or your software will crash, and that 6G 
could make a big difference to its users 
and purchasers. A little above that, the 
bits of your program are carefully 
compiled to run on a specific family of 
microprocessor; the system calls in 
your program are linked to a specific 
operating system API; and the logical assumptions are based 
on the performance and capabilities of a certain range of 
hardware platforms. All of these choices are encoded into 
your finished product, and they make a substantial difference 
in who will buy and use it. 

Above that, of course, are the features and functions of 
your product itself. This is supposedly what yore good at, and 
ostensibly what your customers are paying money for. Of all 
the investments you make in research and development, the 
information you learn about how to make your program solve 
the customers’ problem should be most worthwhile to you and 
to them, shouldn’t it? 

But as you’re probably aware, your choice of platform 
often makes more of a difference to your customers than your 
choice of features or technologies. Everybody in the Mac 
business has been told more than once that ‘your product is 
great, but if it doesn’t run on IBMs I can’t use it.’ And you 
spend much of your time and money simply porting your 
application from one system version to the next, or from one 
hardware platform to another — and recently, from one 
microprocessor to another. The differences are significant, 
because compiler technology, hardware evolution, and new 
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... your product is great, 
but if it doesn’t run on IBMs, 
I can’t use it.?? 


system APIs are not simple things; but at least they make a 
difference to your customers. 

What will happen if these differences stop making a 
difference? What if, for example, you didn’t have to worry about 
what instruction set to compile for? In a small way it’s true now 
— if your application is not speed-sensitive, you can just compile 
it for the 68K, and the emulator on the Power Macintosh 
products will automatically run your software on the Power PC- 
based models. And while emulation is 
admittedly slower than running native, 
you could be seeing more processor 
independence in the future. Apple’s 
Advanced Technology Group and 
others in the industry have been 
researching processor-independent 
object file formats. With these, you 
compile and link your application into 
intermediate code which you ship to customers; then either the 
Installer or the segment loader transliterates the code into the 
correct instruction set for each machine. The hardware vendor 
can use different CPUs, the users get native performance, and 
you can ship one program that runs on many brands. 

And with processors continuing to get faster and cheaper, 
and multiprocessor designs starting to become available, 
emulators might be the big win after all. If you can add more 
processors to run your emulators faster, you might be able to 
achieve near-native performance through emulation. Just think: 
if you want to run Windows applications faster, just keep adding 
more Power PC chips to your Macintosh until it’s fast enough! 

Independence from hardware architecture is getting easier 
as well. In modern OS architectures, a “hardware abstraction 
layer” separates the OS kernel from the particular hardware 
implementation, making it easier to port the OS to different 
hardware platforms. And developers of new platforms are 
trying an alternative to the defacto standards of Macintosh 
(controlled by Apple) and the Intel-based PC architecture 
(controlled by nobody in particular). The result is a set of 
“reference platforms,” hardware designs that assure certain 
capabilities in different vendors’ designs. The last major 
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reference platform, ACE, was built around Windows NT and the 
MIPS chip; the current hot platform, PReP, is based on the 
Power PC chip and AIX. If reference platforms dominate the 
landscape in the future, it should be easier to write code that 
runs indifferently on multiple platforms. 

Finally, APIs are crossing the hardware boundaries. Both 
OpenDoc and OLE 2.0 are cross-platform, though they don’t 
isolate you from other toolbox calls. Hosting layers like XVT 
and Novell Appware Foundation add surprisingly little overhead 
to run the same API on different underlying toolboxes. And 
future operating systems like Taligent’s Pink system and IBM’s 
Workplace Shell are meant to host multiple “personalities” on 
one OS kernel, so your choice of hardware vendor doesn’t 
dictate your choice of API, and therefore applications software. 

So five years from now, our old landmarks — the instruction 
set, the hardware architecture, and the API - may be rotting and 
fallen. Will it be a total mix-and-match world? Will people be 
running Mac code in an emulator box on Windows NT on a 
Compaq Power PC platform, or x86 OLE objects wrappered by 
OpenDoc running on OS/2 on a Macintosh with a Cyrix chip 
emulating the Pentium in microcode? 

I say: yes and no. I expect that the majority of successful 
commercial software will be (more or less) compiled and built 
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for a specific class of microprocessor, hardware platform, and 
API. It'll just be easier that way, both technically and in the 
marketplace. Though the technology might be able to jump 
through hoops, the channels and customers don’t get over such 
fundamental taboos as “incompatibility” overnight. 

But while compatibility may remain a litmus test, itll no 
longer be a barrier. In-house developers will be able to 
compile something once and deploy it on their Mac, Windows, 
and UNIX machines, letting adapters and emulators take care of 
details. Or you could take a product that’s successful on one 
platform, test-market it in the emulator community on other 
platforms and, if it sells, then invest in the native port to 
increase your market share and competitiveness. Or (for extra 
credit) you could find clever ways to bridge the various 
environments, perhaps hooking up TAPI in SoftWindows to the 
Geoport or AV capabilities on a Power Macintosh. 

Old differences die hard. Even after technology has made 
them irrelevant, the distinctions of architecture will color 
peoples’ thinking. Most conventional development will 
probably remain the way it’s always been, but there may be 
some interesting new opportunities when the gaps between 
platforms are bridged over. © 
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Information 


“The Debugger’ is a low and high-level symbolic Debugger 
that runs in a full multi-window Macintosh environment. You 
can trace program execution, view the values of variables, 


etc. Of both 68K and PowerPC programs. 





MacNosy is a global interactive disassembler that enables 
one to recover the source code of any Mac application, 
resource file or the ROM. 


When you compare features of the different debuggers, 
note that ONLY ONE has ALL the below features to help 
you get your job done, and ONLY ONE has MacNosy to 
help you debug any program in a full system (6.0x or System 
7.x) environment symbolically! 


It is the ONLY debugger to use the MMU to protect your 
CODE resources and the rest of the system from the 
program you are debugging. With MMU Protection you can 
find errors when they happen, not millions of instructions 
later! (Macintoshs with 68030 CPUs only) 


The Debugger is the debugger of choice at: Adobe, Aldus, 
Claris, Electronic Arts, Kodak, Metrowerks, etc. 


Its features include: 


¢ Symbolic Debugging of ANY Macintosh program, ROM, or 
code resource (DRVRs, XCMDs, INITs, PDEFs, 4DEXs ..) 


e Source level debugging for Metrowerks & MPW 
compiled programs (C++, C, Pascal, Fortran, ...), and an 
Incremental Build System with instant Link for 
superfast development. 


e Object Inspector for MacApp 3 programs 
¢ Source level debugging of Think C™ projects. 


¢ Includes a program(CoverTest) to interactively do 
Code Coverage analysis for SQA testing, etc 


e Simultaneous Symbolic debugging of multiple “tasks” 


The Debugger V2 
& MacNosy 


by Steve Jasik 


Gives you the Information to program your Best! 





Control 


e Fast Software Watchpoint command to find clobbered 
variables 


¢ Sophisticated error check algorithms such as Trap 
Discipline (Argument Checking), Handle Zapping, Heap 
Scramble and Heap Check to detect program errors before 
they become disasters 


e Structured display of data (hypertext) with user definable 
structures while debugging 


e Conditional breakpoints to help filter out redundant 
information 


¢ Continuous Animated Step Mode to watch your program 
execute instruction by instruction. 


¢ Detailed symbolic disassembly for both 680x0 and 
PowerPC with symbol names, labels, cross ref maps, ... 
make it possible to ferret out the secrets of the ROM, etc. 


¢ "Training Wheels" for the PowerPC disassembler to help 
you learn the opcodes. 


An example of a structured data display window: 
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The Debugger V2 & MacNosy: $350 (runs on all Macs) For Group prices or Updates - call 


Visa/MC Accepted 


Jasik Designs, 343 Trenton Way, Menlo Park, CA 94025 


(415) 322-1386 


Available from: Jasik, APDA, Frameworks or ComputerWare (800-326-0092) 





: bs TOOLS OF THE TRADE 


By Jess Holle, Purdue University 





A REVIEW OF SYMANTEC C++ 7.0 


Symantec’s new release is solid and feature rich 


ABOUT THE AUTHOR 
Jess Holle is nearing the completion of his Master's 
Degree in Mechanical Engineering at Purdue University. 
He works as a research assistant in the Purdue CADLAB 
developing CAD/CAM software in C++. His current 
research efforts center on developing a 3D GD&T (that’s 
Geometric dimensioning and tolerancing (ala ANSI Y14.5) 


for you curious types) tolerance scheme in a feature- 
based design environment. 

Jess uses Symantec Ct+ primarily to port software 
from Silicon Graphics systems to the Macintosh for 
debugging, portability testing, and demonstration 
purposes. You can reach Jess at jess@ecn.purdue.edu 


In May of 1993, Symantec released Symantec C++ 6.0, a C and 
C++ development environment based on its popular Think C 
environment. The new modular environment included two 
compilers: the case-hardened Think C compiler and a native 
C++ compiler, which was based upon the Zortech compiler 
Symantec had purchased. Finally there was a real alternative to 
MPW for C++ development on the Macintosh. 

Unfortunately, the 6.0 C++ compiler was less than solid. 
The bug-fix release, 6.0.1, failed to bring the compiler in line 
with user expectations. On-line forums, such as 
comp.sys.mac.programmer on the Usenet, were filled with 
complaints and bug reports. 

Symantec’s response was to enlist its most vocal detractors 
as beta testers for Symantec C++ 7.0 (myself included). The 
result is a solid C++ development environment with some of the 
best C++ debugging features on any platform. 

[This review gives a brief overview of the product, but 
focuses mainly on the language itself. We will bring you a 
review of the TCL and Visual Architect in July. This review also 
only deals with the 68K product; the cross-compiler was not 
available for review as of this writing — Ed stb] 

In addition to 6.0’s integrated debugger, scriptable project 
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manager, support for external editors, integration with Apple’s 
SourceServer, and on-line help for the standard C and C++ 
libraries, Symantec C++ 7.0 also provides: 


e Improved C and C++ compilers 

© Universal headers, facilitating PowerPC compatible source 

¢ Inspector, a heap analyzer tool 

© Think Class Library (TCL) 2.0, a fully C++ framework with 
support for persistent objects, AppleEvents, and scripting 

© Visual Architect, a visual interface builder for TCL 

e AppleScript 1.1 

e A 60-day money back guarantee 





661 have successfully compiled tens 
of thousands of lines of C++ code 
(including multiple inheritance, 
operator overloading, and nested classes) 
with Symantec C++... ? 





Symantec C++ 7.0 requires: 

e 8 megabytes of RAM (12 megabytes recommended) 

e System 7.0 or later in order to use all features — basic 
environment and source-level debugging supported under 
6.0.7 and later 

e A hard drive, 17 MB for a full install or about 7 MB for a 
fairly minimal install (essential tools, libraries, and headers) 


PROJECT MANAGER 

Symantec 7.0’s Project Manager is much the same as in 6.0, 
with a few small changes. Besides the addition of color, the 
project window, shown in Figure 1, has remained unchanged. 
Source files are added to segments in the project window, and 
the Project Manager keeps track of which files’ object code 
needs updating. Segments can be named, collapsed, and 
expanded in the project window for segmentation control and 
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simple source organization. The production of symbolic 
debugging information is controlled via toggling the bullet in the 
debug column. Projects can be included within other projects as 
libraries and hopped into by double clicking on the included 
project’s name. The integrated editor displays files selected from 
the project window and contains quick links to on-line reference 
information, header files, and the class browser. 

One nice improvement is the New Project dialog shown in 
Figure 2. Any project placed in Symantec’s Project Models 
folder will appear in this dialog and serve as a stationary for 
new projects, retaining all of its original libraries and settings. 


: 152 
i CPlusLib 29 
i main.cp a5 - 


* vector <char>.cp 
* vector <float>.cp 
* vector <int>.cp 


* selection(char).cp 
* selection(float).cp 
* selection(int).cp 





Figure 1 New project window and menus 


A new AppleScript, which removes all files from a given 
segment of a project, has been provided. This alleviates a 
constant source of complaint for Symantec users: files have to be 
removed from a project one at a time. For large projects, this 
became quite tedious. This AppleScript, along with all others 
placed in Symantec’s AppleScripts folder, can now be executed 
through the new scripts menu seen at the far right in Figure 1. 







ANSI Project 
C++ 10Streams Project 
C++ Project 

Empty Project 


















x] Create folder 








CSS 


Figure 2 Improved New Project dialog 


Other improvements include: 

¢ Code segments that are greater than 32K can be 
automatically resegmented (at file boundaries) 

¢ The Find dialog remembers old search and replace strings 
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CLASS BROWSER 


symantec’s class browser now allows larger and more 
complex hierarchies to be viewed. Though by no means as 
full-featured as source browsing products such as Object Master, 
symantec’s integrated browser provides an attractive, 
economical alternative. Each class is represented as a box, with 
base classes shown on the left and lines linking them to their 
subclasses on the right. Each box serves as a pop-up menu of 
methods through which corresponding source code can be 
obtained. Double-clicking on a box brings up the class’ header 
file. When using Symantec’s built-in editor, option-double 
clicking on any method name in the source will bring up the 
class browser and hilite all classes which define the method, as 
shown in Figure 3. I have found Symantec’s browser to be 
enormously helpful when exploring huge bodies of code and 
tangled class hierarchies. 
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Figure 3 Class Browser 


COMPILER STABILITY 


The C++ compiler is drastically improved over the previous 
version in almost all respects. The parsing, standards 
compliance, code generation, and error recovery are 
significantly better than in 6.0.1. In the later stages of beta 
testing, the compiler passed over 99% of the MetaWare 
verification suite. Quoting the release notes, “all known code 
generation bugs have been fixed.” I have successfully compiled 
tens of thousands of lines of C++ code (including multiple 
inheritance, operator overloading, and nested classes) with 
Symantec C++, with only one workaround for the compiler. All 
other compilers that I’ve had the opportunity to try have 
required changes to my source code. 


MULTIPLE INHERITANCE 


One area where the C++ compiler really shines is multiple 
inheritance. As Grady Booch states, “Multiple inheritance is 
like a parachute; you don’t need it very often, but when you 
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do it is essential.” 

Few compilers seem to get multiple inheritance right. Most 
CFront implementations prior to 3.0.2 and Symantec C++ 6.0.1 
can produce bad code for cases as simple as the class hierarchy 
shown in Figure 4. 


Se 


Figure 4 Multiple Inberitance Class Hierarchy 


Table 1 shows the results of a sample program based on 
this hierarchy. In this test, a virtual function, GetO, is defined in 
classes A, B, and C. An instance of class CC is created and 
Get(Q) is called through a pointer of type AA as follows: 


AA *a = new CC; 
a->Get(); 


The most derived version of GetQ, C::GetO, should be 
called here, print the this pointer and return 5. It is evident 
from Table 1 that CFront 3.0.1 does not produce correct code 
here (a slightly different program causes a crash). The cause is 
also readily apparent: the this pointer has been miscalculated 
by CFront for C::GetQ. 


TABLE 1 SAMPLE PROGRAM RESULTS 


Variable Symantec C++ 7.0 CFront 3.0.1 

this in C::CO af239e 1000b050 

this in C::GetQ  —af239e 1000b02c (wrong) 
C::GetO 5 268480656 (wrong) 


MPW C++ correctly generates code for this simple example, 
but fails on more complicated hierarchies. Symantec Ct+ 7.0 
generates correct code for all multiple inheritance cases that I’ve 
tested, including projects with five generations of multiple 
inheritance (counting the hierarchy shown in Figure 4 as two). 
This has allowed me to #ifdef out dozens of workarounds 
needed with some other compilers. 


LANGUAGE FEATURES 


The C++ language has recently seen the development of 
several major features: templates, exception handling, and RTTI. 

Templates, the oldest of these additions, allow the creation 
of general parameterized types and functions such as those 
shown here. 


template<class Type» class array { 
public: : 
Type “*a 
array( int size ); 
e 
template<class T> Type min( T a, Tb); 


Once defined templates can then be “instantiated” for a 


JUNE 1994 


particular type by using them in source code as follows: 


array<float> v(4); 
array<myClass> c(10); 
min(1,2); 

C++ exception handling allows error handling code to be 
separated from normal execution code and packaged in a cleaner 
fashion. Unlike C’s longjmp, C++’s exceptions handling not 
only unwinds the stack, but also frees memory allocated from the 
stack, and calls destructors on class objects as needed. Exception 
handling also increases the utility of C++’s constructors by 
allowing failures within the constructors to be caught. 

RTTI, or run-time-type-information, gives the ability to 
determine an object’s exact type at run time. Besides the obvious 
benefits of this, RTTI also allows safe, dynamic type casting 
between pointer types, including from virtual base classes to their 
derived classes, returning NULL if the cast is not possible. 

Symantec C++ 7.0 adds no major language features to the 
compiler itself, though templates are now significantly more 
stable. Symantec still requires templates to be manually 
instantiated in source files such as the following (in addition to 
simply using them as shown above). 


// array<float>.cp: template instantiation file 

include "array.cp" 

pragma template array<float> 

pragma template operator<<(ostreamé, array<float>&) 
#fpragma template_access public 

The most recent major C++ language features, RTTT (run- 
time type information) and exception-handling, are not yet 
implemented in the Symantec C++ compiler. These features are 
implemented by macros and classes in the Think Class Library, 
however. This is an interim solution until compiler support for 
these features is added. When the compiler supports these 
features, the macros will be rewritten to use new compiler 
features so that no source changes will be required. 

While code based on these TCL implementations is not 
portable like the standard C++ features (without writing some 
conversion macros), much of the functionality of these C++ 
features is present in the current TCL implementations for those 
who need it. Exception handling and RTTI do not require the 
entire mass of TCL, but rather just the Bedrock exception library, 
Exceptions.cp, and Exceptions.h. The following program 
demonstrates the syntax required to use exception handling and 
to declare a RTTI-aware class in Symantec C++ 7.0. 


include <iostream.h> 
#include <Exceptions.h> 


class Overflow TCL_EXCEPTION_CLASS 
{ 
public: 
TCL_DECLARE_CLASS 
Overflow(char A, double B, double C) {a=A; b=B; c=C; } 
char a; 
double b,c; 
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Cross-Platform Object Database Engine 


Easy to Use NeoAccess is a set of easy to understand 
C++ classes that extend the capabilities of PowerPlant, 
MacApp and the THINK Class Library on the Macintosh 
and MFC, ObjectWindows and zApp in Intel-based 
environments. Suddenly persistent C++ objects are first- 
class citizens that can be organized and accessed naturally 
using an API designed for minimum visible complexity. 
And to make things even easier, NeoAccess comes 
complete with full source code. 

Full Featured NeoAccess includes support for blobs, 
part lists, iterators, swizzlers, temporary objects, multiple 
indices on a class, a powerful relational query mechanism, 
duplicate keys, transactions, a versatile streams I/O model 
and performance beyond compare. NeoAccess has a huge 
storage capacity with no database administration to worry 
about. And databases are standard document files with 


NeCOACCeSS., 


your application icon on them. They are also binary- 


compatible across platforms. 
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neos logic 
In order to survive, you need to persist. 


High Performance The use of binary trees and an 
efficient object caching mechanism means very fast access 
to objects and reduced file I/O. Only objects of immediate 
interest need to be in memory, so your applications can be 
much smaller, even when accessing huge databases. 
Proven NeoAccess is becoming the object database 
standard. Hundreds of commercial and in-house C++ 
developers are using NeoAccess to develop powerful multi- 
media, document management, CAD, data visualization 
and many types of vertical applications. NeoAccess is what 
your organization needs to realize its potential. 
Affordable NeoAccess's best feature is its price. The 
NeoAccess Developer's Toolkit sells for just $749 per 
developer with no runtime licensing fees. It includes full 
source code, numerous sample applications and 350+ 
pages of well-written of documentation. 
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TCL_DEFINE_CLASS_M0 (Overflow) ; 


Static void f(double x) { 


throw_(Overflow('+', x, 


} 


3.45e107)); 


void main() 


{ 


// uncomment next line to skip Debugger() call when an exception is caught 
TCL_BREAK_ON_CATCH(false) ; 


try_ { 


// ARM p. 358, GREY p. 603 
cout << "example 2:" << endl; 
try_ { 

PU 2G 


} 
catch_all_() {  //catchall exceptions 
// respond (partially) to exception 
cout << "exception partially handled" << endl; 
throw_same_(); // pass the exception to some other handler 
} 
end_try_ 


catch_all () { 


} 


cout << 


"rethrown exception caught again in outermost catchall ()" 
<< endl; 


end_try_ 


} 


SYMBOLIC DEBUGGER 
Symantec’s 7.0 debugger, which is identical to that in 6.0 


with the exception of bug-fixes, is shown in Figure 5. 
Breakpoints are set by clicking on diamonds appearing along 
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the edge of the source window. Buttons and keyboard 
equivalents provide easy source stepping. Data values can be 
displayed and modified by selecting them in the source window 
or typing in the Data window. Classes, structures, and arrays 
are displayed in individual named windows. 
@ File Edit Debug Source Data Windows 
6CtHole.cp 


void GCIlHole::DrawFeedDirs¢ CMatrix &ctm, CUector &ty ) 
if 
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Figure 5 Symbolic Debugger 
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Symantec’s debugger provides a feature that is usually 
associated with interpreted environments: the ability to evaluate 
general C and C++ expressions, including method calls, 
preprocessor defines, and overloaded operators, on the fly. This 
ability is extremely useful when debugging complex code. 
Rather than adding lines into the program, recompiling and 
viewing the results, one can use Symantec’s debugger to evaluate 
expressions of interest at any time. The debugger also allows 
breakpoints to be conditional on the results of such expressions. 

There are several limitations to this. Since the expressions 
are compiled and run on the fly, the expression must be 
something the compiler can understand in the current scope. 
Due to the dependence on the compiler, the debugger cannot 
be run apart from the Think Project Manager. Also, file writes 
and other “side effects” will not operate correctly when 
operating from such an expression, and the debugger will 
complain accordingly. The Data window in Figure 5 shows 
several uses of this general expression evaluation capability. 

I have found the Symantec debugger to be extraordinarily 
helpful and have ported several projects to Symantec C++ from 
the SGI Iris mainly to take advantage of it. Its ability to evaluate 
source expressions on the fly is particularly useful. 


THINK INSPECTOR 


The THINK Inspector is a completely new memory heap 
inspection tool. It is intended both for tracking down memory 
leaks and for quickly navigating through heap-based structures, 
such as linked-lists, which are generally somewhat tedious to 
traverse when debugging. Figure 6 shows the Inspector 
displaying objects of several class types. 
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Figure 6 THINK Inspector 


The Inspector runs in conjunction with the debugger, and 
tracks the creation and deletion of all C++ class objects with 
virtual destructors. Inspector’s data is updated when the 


26 MACTECHMAGAZINE 





program stops in the debugger, operating via hooks in the new 
and delete operators (which must be added to user-defined new 
and delete operators if their objects are to be inspected). 

The upper-left pane of each Inspector window is a list of 
classes, either alphabetical, or hierarchical, as shown here. 
Classes are selected from this list for inspection. Menu items 
allow either all classes with active instances or the next such 
class to be selected from this list. 

The lower pane lists all the methods for any selected 
classes. Selecting a method will display its source in the 
debugger’s source window. This pane presents a handy 
alternative to the class browser while debugging. This and the 
upper left pane bear a great deal of similarity to Apple’s 
SourceBug, with the exception that the THINK Inspector 
understands C++ class inheritance. 

The upper-right pane is the heart of the Inspector. It 
shows the current instances of any classes selected from the 
class list. Data members pointing to other heap-based objects 
can be expanded in a fashion similar to the Finder's list views. 
Figure 6 shows a linked list being inspected. Note that though 
each object contains only a void pointer, the Inspector knows 
the actual class type of each object. If further viewing options 
or changes to data are desired, any portion of this pane can be 
sent to the debugger’s data window via a menu item for further 
manipulations. A menu item allows the source line where a 
selected instance was allocated to be displayed. 

Multiple inspector windows can be active at any time, 
allowing instances of different classes to be tracked 
simultaneously in different windows. Each window’s panes are 
resizable and can be viewed in any text size and font. All 
window positions and preferences are saved between executions. 

Memory leak tracking with the THINK Inspector is very 
easy. Simply set a breakpoint where you'd like to check up on 
memory usage and inspect the active instances of any classes of 
interest. By placing a breakpoint immediately before the end of 
the program and selecting a menu item, any class objects 
allocated throughout the entire execution that have not yet been 
deallocated can be quickly viewed. 

Overall, the Inspector greatly enhances the debugging 
capabilities of Symantec C++ 7.0. I have found it very useful for 
checking for memory leaks and for traversing object pointer chains. 


SYMANTEC VS. THE COMPETITION 


Until recently, Symantec’s only competition was MPW, 
which is significantly slower and harder to learn. Recently, 
however, Metrowerks introduced Code Warrior, a development 
release of a C, C++, and Pascal environment similar in many 
respects to Symantec’s. 

The object size and compilation speed for the two 
environments are compared in Table 2 for both a small C project 
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and a medium-sized C++ project. The timing shown is for the 
Metrowerks 68K code generator running on a 68K machine 
[Their PowerPC version of the 08K code generator was not timed 
for this comparison — Ed stb/. It appears that Symantec’s C 
compile times are slightly longer and the code produced is 
slightly larger than that produced by Metrowerks. Symantec’s 
C++ is much slower than Metrowerks’ C++, but Symantec C++ 
generates smaller code. I did not determine how much of this 
speed difference is due to my source file arrangement (Symantec 
searches for files during each build while Metrowerks caches file 
locations). All results are for near/small code with Macsbug 
symbols off. The results varied somewhat given different 
compiler settings, file organization, and choice of code samples, 
but these results are generally representative. 


TABLE 2 A BRIEF TIME & SIZE COMPARISON 


Symantec Metrowerks 
Source Code C++ 7.0 Code Warrior DR/2 
Time Size Time Size 
C (size-optimized) 171s 124K 129s 116K 
C++ (unoptimized) 954s 399K 468s 470K 
C++ (size-optimized) 1701s 304K 479s 454K 


In the battle for features, both environments have their 
advantages. Metrowerks boasts faster compile times and lower 
memory requirements for less than half the price; and both native 
68K and PowerPC environments at $200 less than the price of 
Symantec’s C++/cross-compiler combination. Symantec's 
advantages include its class browser, Visual Architect, heap 
Inspector, debugger source expression evaluation, and smaller 
object code. A brief feature comparison is given in Table 3. 


CONCLUSIONS 


Symantec C++ 7.0 is a big improvement over 6.0 and a 
good, full-featured environment. The C++ compiler itself, as 
well as almost every other component, is much more solid than 
in the 6.0.1 release, and is one of the most complete C++ 
compilers available. The debugger’s ability to easily evaluate 
general C and C++ expressions on the fly is still unique on the 
Macintosh platform. The new THINK Inspector eases the 
burden of tracking heap-related problems. The inclusion and 
support of AppleScript, the updated TCL, and Universal Headers 
make this a well-rounded release. The biggest item missing is 
an available native PowerPC environment. 

When considering purchasing Symantec C++ 7.0, two 
additional items should be considered: 

e A C++ PowerPC cross-compiler is available for Symantec C++ 
for $100. Symantec views this as an interim solution until 
their native development system is ready for release. No 
release date has been announced for Symantec’s native tools. 
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TABLE 3 FEATURE COMPARISON 
OF SYMANTEC AND METROWERKS 

















Metrowerks Code 
Feature Symantec C++ 7.0 Warrior DR/2 (68K) 
Language Features 
Templates Yes No 
ANSI Exception 
Handling No (TCL-based No 
implementation) 
ANSI RTTI No (TCL-based No 
implementation) 
Allows code segments No Yes 
greater than 32K 
Dead Code Stripping File-level Function-level 
Class browser Yes No 
Heap Analyzer Yes No 
Debugger 
Source evaluation Yes No 
in debugger 
Debugger can be No Yes 
run separately 
PowerPC Support 
Cross-compiler Native environment 
available available 
Code generation XCOFF PEF 
Linker Apple’s MakePEF et al PEF Linker 
68K support on None Native cross-compiler in 
PowerPC native environment 
Function-level segmentation No Yes 
Builds MacApp No Yes 
Editor Keyword Coloring No Yes 
List Price 
68K $499 $199 (fat binary) 
PowerPC - $299 (fat binary) 
PowerPC/68K - $399 (2 fat binaries) 
68K to PowerPC $100 part of PowerPC 
cross-compiler fat binary 
Distribution Media Floppies CD-ROM 


¢ A free bug-fix upgrade from 6.0.1 to 7.0 versions of the C, 
C++, and Rez compilers, the debugger, and the project 
manager is available. All new components, libraries, and 
header files are available at an upgrade cost of $149 to 
Symantec C++ 6.0 users and a list price of $499 for new 
copies. Those who purchased version 6.0 on January 7, 
1994 or later, can upgrade to 7.0 at no charge. 

[One last thing: Symantec C++ 7.0 comes with 2000 pages of 

new, printed documentation — Ed stb] {Also, by popular 

demand, Symantec’s tools are available in the Mail Order Store. 


— Ed nst} 2 
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‘ 4 TOOLS OF THE TRADE 


By Jeffrey Mattson 








USING THIRD-PARTY EDITORS WITH SYMANTEC C++ 





Going beyond the basics 


INTRODUCTION 

THINK C’s integrated editor has long been a mixed 
blessing. While it’s useful to have everything you need to start 
programming in one package, experienced users soon long for 
more sophisticated features, such as macros and file 
comparisons. However, THINK C couldn’t communicate with 
other editors as it could with its own integrated editor, and that 
made matters difficult. For example, when you edited a file with 
another editor, THINK C wouldn’t know that you changed the 
file and that it needed to be recompiled. You’d have to explicitly 
mark the file for compilation. The hassles of using a third-party 
editor soon outweighed the convenience of any new features. 


6 Both editors offer many features 
missing in the THINK 
Project Manager editor. 9 


With the advent of System 7 and the latest version of 
THINK C and Symantec C++, you now have a choice /and you 
can get an editor which knows how to search forwards and 
backwards — ed stb]. The THINK Project Manager in THINK C 
and Symantec C++ can communicate with other editors with a 
suite of Apple Events. However, editors have to be designed to 
use these Apple Events. Two such editors are BBEdit from Bare 
Bones Software and QUED/M from Nisus. 


GETTING STARTED 


Setting up an editor to use with the THINK Project Manager 
is fairly easy. In the Finder, create an alias of the editor with the 
Make Alias command, rename the alias to “Editor”, and move it 
to the Tools folder in the THINK C or Symantec C++ folder. In 
the THINK Project Manager, open your project, and turn on the 
“Use external editor” option in the Editor page of the THINK 
Project Manager options dialog. 
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If an operation would normally open a file in a THINK 
Editor window, it now opens a window in your editor. When 
you double-click on a file in the project window, an error in the 
Compiler Errors window, or an entry in the Search Results 
window, the THINK Project Manager now uses your editor of 
choice. The editor even scrolls to the line that contains the error 
(or search string) and selects it. 


WHAT WORKS WELL 


The editors implement most of the features that the THINK 
Project Manager allows and they implement these features in 
eerily similar ways, right down to the titles on their menu bars. 
Both editors have a special THINK Project Manager menu and 
they use as their title the THINK Project Manager icon. The 
menus contain similar commands to handle the most common 
tasks: running your project, adding the front most window to 
your project, compiling a file, and building the application. 
QUED/M even gives the commands the same command key 
equivalents as the THINK Project Manager, and it has some 
additional commands that the THINK Project Manager lacks, 
such as one that runs your project without the debugger, 
regardless of the setting of the Use Debugger option. 
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QUED/M in use 


An unexpected extra is that both editors let you open header 
files just as you do in the THINK Project Manger. When you 
command-click on a source file’s title bar, the editor displays a 
menu of header files. However, be sure to hold that mouse button 
down for a while. There can be a noticeable delay as the editor 
goes off to get the information from THINK Project Manager. 

Both editors are integrated with THINK Reference. They let 
you look up the selected text in THINK Reference and they can 
even insert the declaration of the selected function name. 
BBEdit will launch THINK Reference for you if it’s not already 
running. By the way, don’t let the name of BBEdit’s command 
confuse you. Although it’s called Toolbox Lookup..., it can also 
look up the names of standard C library functions in the 
databases included with THINK C and Symantec C++. 


WHAT DOESN’T WORK 


Unfortunately, you do lose some of the convenient features 
in the THINK editor when you use a third-party editor. One loss 
that’s deeply missed is the Option-double-click shortcut. When 
you Option-double-click on a function or variable name in the 
THINK editor, the editor finds the function or variable definition 
and opens the file that contains it. Neither editor contains this 
feature. [This is a result of the Think Project Manager not 
providing a mechanism for an external editor to search for the 
definition of a global name — Ed stb]. 

Most importantly, you must remember to save your files 
frequently. If you’ve used the THINK editor before, you’ve 
probably grown accustomed to the option that saves your files 
automatically before the THINK Project Manager runs your 
project. However, when you use another editor, the THINK 
Project Manager doesn’t tell that editor to save your files before 
it runs your program. If your machine crashes while your 
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program is running, you'll be unpleasantly surprised to find that 
all your changes are lost. And if you manage to finish an editing 
session (after your application has crashed), you may still get an 
unpleasant delay on the next build, because the THINK Project 
Manager doesn’t know that the newly-saved files contain code 
that it’s already compiled. The next time you open the project 
and compile it, the THINK Project Manager marks all those files 
and recompiles them. This wait can be a real hassle if you 
changed a lot of files before. The only solution to both these 
problems is to save the files yourself before compiling them. 

Correcting errors can be a nuisance with THINK. When you 
double-click on an error in the THINK Project Manager's 
Compiler Errors window, the editor opens the file and selects 
the line, and then repeats the error in a dialog box. If you've 
just double-clicked on the error, you don’t need to see it again. 
Both editors let you go to the next or previous error, without 
going back to THINK Project Manager. 

BBEdit also has a Compile Errors browser. The top of the 
window contains a list of all the errors, the bottom displays 
source for the selected error. When you click on an error, the 
bottom of the window displays the file and highlights the line 
that contains the error. However, you cannot correct the error in 
the browser, but you can double-click on the error, and BBEdit 
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“BBEdit provides much functionality in an uncluttered interface that belies its power.” — ridB/Ts, issue no. 202 


By the way: Macintosh, MPW, and ToolServer are trademark of Apple Computer, Inc. THINK C and THINK Reference are trademarks of Symantec Corp. 





opens the file and selects the faulty line 

For some reason, BBEdit doesn’t always create a Compile 
Errors browser when there are compilation errors. There is 
some sort of mis-communication between BBEdit and the 
THINK Project Manager. 

[Because you're working with two programs (BBEdit and 
THINK Project Manager), things can get a bit tricky when it 
comes to error reporting. BBEdit doesn’t get told about errors if 
the THINK Project Manager is “in charge of” the compiling. For 
example, if you choose “Bring Up To Date” while you're in the 
THINK Project Manager, it will do the job and not report errors 
to BBEdit. It’s arguable that it should report the errors to BBEdit 
since you've told it you’re using an external editor, but it’s also 
arguable that it shouldn't since you issued the command from 
inside THINK Project Manager. There’s another case where the 
limitation clearly comes from the THINK Project Manager, and 
that’s when you choose “Run” from the external editor. THINK 
Project Manager poses the dialog asking the user whether to 
bring the project up to date. If the user clicks “Update”, the 
THINK Project Manager initiates the build, and keeps error 
information to itself. This is something under discussion 
between Symantec and external editor folks. One workaround is 
to always use the external editor’s “Bring Up To Date” command 
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before running. — Ed stb] 

Neither editor works particularly well with the THINK 
Project Manager’s regular multi-file search, in which the THINK 
Project Manager searches the files in your project for a string, 
and displays each occurrence of that string as it finds it. BBEdit 
doesn’t include any support for this but provides its own 
approach. QUED/M tries to support it, but I could never get it 
to work correctly. (Whenever I choose QUED/M’s “Go to Next 
Error/Match” command, it never finds the next occurrence in 
the file. ) However, both editors work well with a batch multi- 
file search, in which the THINK Project Manager lists all the 
occurrences of your string in a Search Result window, and you 
look at an occurrence by double-clicking an entry. 


ADDITIONAL FEATURES 


Both editors offer many features missing in the THINK 
Project Manager editor. They both save window positions, a 
frequent request for the THINK editor. When you reopen a file, 
these editors remember where you last placed its window, and 
the editors place the window there. 

They both perform parenthesis matching, letting you know 
which open parenthesis matches the closing parenthesis you 
just typed. BBEdit’s parenthesis matching is easier to 
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understand, but QUED/M’s is more powerful. QUED/M beeps 
when you type a closing parenthesis that has no opening 
parenthesis, for example, while BBEdit does nothing. QUED/M 
also lets you edit the list of characters and strings that it 
considers to be parentheses. For example, if you’re editing 
Pascal code, you could have the editor treat the words BEGIN 
and END as parentheses. 


66 The ability to choose a third-party 
editor certainly is a boon to the most 
particular of the power users. 9 





Both editors let you add external commands. In BBEdit, 
you need to create a special kind of code resource with a C or 
Pascal compiler. QUED/M has its own macro language, and it 
lets you record a macro as you work or type one up separately. 
Neither supports AppleScript yet. 


«Smart Quotes 
// This macro replaces almost all (exceptions noted below) single and double 
// straight quotes with curly quotes. It does not replace a single quote following 
// a digit (feet designator) and two single quotes at the end of a digit 
// (inches designator). 


// Replace double quotes preceded by a space, a return, tab, left parenthesis, 
// brace or bracket, with curly opening quotes. 
Change "\(:<[\s\r\t([{]""\Ji:s""" "“" "a-whgt" 


// Replace all remaining double quotes with curly closing quotes. 
Change nunn ug "a-wAgt" 


// The same for single opening quotes. 
Change “\G<[ \r\t(E{)'\)Ics'" "*" "a-wagt" 


// Replace single opening quote nested next to a double opening quote 


Change wegen ugu “a-wAgt" 


// Replace closing quotes which are not preceded by a digit or another single 
// quote with closing single quote. 
Change ":<[*'0-9]\>"" "’" "a-wAgt" 


// The remaining single quotes not preceded by a digit must be apostrophes. 
Chan " "a-wAgt 


pices? Seay SURE HEURES SCENES US REE EERE REE AE 
ie sy (IIL SCRE eter ego NG 





QUED/M Macro language 


Finally, they perform file comparisons. When you have two 
versions of the same file, a file comparison command can point 
out where the text has changed. BBEdit’s file comparison 
feature is easier to use, since you set all its options from one 
dialog. QUED/M’s is more powerful but also more confusing. 
You need to select a couple of different commands to perform a 
comparison, but QUED/M gives you more customization 
options and even lets you compare up to three files at once. 


SPECIAL FEATURES IN BBEDIT 


BBEdit contains several especially useful features that aren’t 
available in QUED/M. For example, you can open a THINK 
Project Manager or THINK Pascal project in BBEdit, which 
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Developers: 


PatchiWorks 


Builds Updaters Without Programming 





PatchWorks has many options, but only one function: 
to create updater applications for distribution to end 
users over channels that may be non-secure (e.g., BBSs). 


Before the advent of PatchWorks, creating an updater 
was a project in itself, one that consumed valuable 
programmer time which could more profitably be spent 
on revenue-producing projects. 


With PatchWorks, you create an updater in minutes. 
Since there’s no coding or scripting, no bugs are 
introduced. Just fill in a dialog, and PatchWorks does the 
rest! 


Distribute updaters frequently to reflect maintenance 
releases, and watch your tech support and fulfillment 
costs fall dramatically. 


Most important, your customers will know you care. 


PW Log - OffLine™ 2.2 
Compression 


Name 


@ Rewrite updater 
© Merge resources into updater 


Type 
Creator 


Old File 


Screen Name 


Name OffLine™ 
New File 


Mod Date C) Copy all 


Features 


¢ Works with apps, INITs, cdevs, fonts, drivers, etc. 

¢ Updaters support up to 8 old versions 

¢ Resource compression (diffing) produces small updaters 
¢ Resource encryption makes updaters hacker-resistant 

¢ Preserves personalization data (name, serial #, etc.) 

¢ Updater distribution is unrestricted & royalty-free 


Pricing: Begins at $195. Call for more information. 


2200 NW Corporate Blvd. 
Boca Raton, FL 33431 
Tel (407) 241-0308 ¢ FAX (407) 241-3195 





MACTECHMAGAZINE 


31 








Tools Plus 


Create a user interface, simplify event handling, and save writing 
thousands of lines of code. Get more done with less work! 


V GUI and Event Handling libraries W Over 100 high-powered 
for THINK C, C++, and Pascal 

V Easy to learn and easy to use 

V Substantial code reduction 

V Dramatic code simplification 

V Significantly less debugging 

V Safer than toolbox routines 

VY CPU, RAM, and disk efficient 

VY No custom resources required 


“set and forget” routines that 
enhance and automate event 
handling, windows, buttons, 
controls, menus, edit fields, 
lists, clipboard, and more... 

V System 6 and 7 compatible 
V Saves time and money 
Y No royalties 


_ Loe Edge Sova 


Tools Plus, only $149 US. 
A free Evaluation Kit is available. SALE 


erent Nn 


Water's Edge Software ¢ Box 70022 © 2441 Lakeshore Road West ¢ Oakville, Ontario ¢ Canada L6L 6M9 
Phone: (416) 219-5628 * CompuServe: 73424,2507 ¢ Internet: 73424.2507@compuserve.com 





displays it in a special type of window called a Project Browser. 
The top of the window contains a list of all the project’s source 
files and libraries. If you select a file, the bottom pane of the 
window displays its contents. If you select a library, the bottom 
pane of the window displays a list of the files the library 
contains. It would be nice to edit files in the browser, but it’s a 
browser. To edit a file, double-click on it and BBEdit brings it 
up in an editing window. You can click on the icon next to the 
“Open” button, and BBEdit will launch the application that 
created the project (either THINK C/Symantec C++, THINK 
Pascal, or CodeWarrior), and open the project. 

BBEdit also has a Disk Browser. The top of the window 
contains a list of all the files and folders that you navigate like a 
Macintosh open file dialog. When you click on a text file, 
BBEdit displays its contents, but doesn’t let you edit it. When 
you click on a THINK Project Manager or THINK Pascal project, 
the browser displays a list of the files and libraries it contains. 
BBEdit supports Claris XTND translators, so you can also view 
many other types of files besides ‘TEXT’ in this browser, such as 
MacWrite or Microsoft Word files. If you open a file that doesn’t 
have an XTND filter, BBEdit displays its data fork as text. This 
can occasionally be useful for things like editing AppleLink or 
ARA CCL files, or rummaging for interesting strings. 
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es bullwindow .c 
<MacTraps> 


i fakeokokestook 
* bul |Menus.c 
* 





* Routines for Bullseye demo menus. 
* 


soko 


#jinclude “bul |Menus.h" 





extern WindowPtr bul | seyeWindow; 
extern int width; 


NenuHandle appleMenu, fileMenu, editMenu, widthMenu; 


enum { 
applelD = 1, 
filelD, 
editlD, 
widthID 
}; 


BBEdit Disk Browser 


BBEdit chose to go a different route than THINK Project 
Manager’s multi-file search, and has its own powerful multi-file 
search command. It can search through all the files in a THINK 
Project Manager project, all the windows open in BBEdit, or all 
the files in a folder. It has a Search Results browser window, and 
it can remember your favorite search directories. It even lets you 
search in an On Location index. When you search in a THINK 
Project Manager project, it doesn’t let you choose which files in 
the project to search, but it keeps the user interface simpler, lets 
you use wildcard matching to filter out files by name, and 
searching is faster than in the THINK Project Manager. 

BBEdit also supports Eric Slosser’s PopupFuncs utility 
which provides a popup list of functions in a source file (it 
works with THINK and MPW, too). 

BBEdit has a backup capability, either automatic or manual. 
The automatic flavor copies the previously-saved version to a 
directory you specify (even on a network volume) and adds a 
date stamp and sequence number. 


SPECIAL FEATURES IN QUED/M 


QUED/M also has backup capabilities, and can store the 
previously saved version of a file as a backup. It can also 
automatically save all the open files after a certain number of 
keystrokes. That simple option can save you unwanted 
frustration when you're developing an application that can 
crash at any moment. 

QUED/M also has some powerful editing capabilities. It lets 
you undo a virtually unlimited number of edits: up to 32,767. 
When you need to return a file to how it was back when your 
program still worked, this feature comes in very handy. 
QUED/M also has ten separate clipboards. You can cut some 
code you might need later into one clipboard, then switch 
clipboards to keep cutting and pasting without disturbing it. 
QUED/M even lets you edit the contents of the active clipboard. 
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OUR COMMITMENT TO SOFTWARE DEVELOPERS 













developers - security, programming flexibility, design, 
and backed by the largest R&D and technical support 
staffs in the industry. 

And when it comes to reliability and compatibility, 


the microprocessor-based SentinelEve3 will run 


And 
Serve. 


When it comes to protecting your software 


transparently with all Macintosh computers with an 
ADB port - including PowerBooks, DuoDocks and 
even PowerPC. 

More importantly, the SentinelEve3 is designed 


to protect your software revenue from piracy better 
revenue from piracy, there’s only one solution 

utilized worldwide by over 10,000 software than any device on the market. 
developers: The Sentinel™ Family of hardware * Randomly Encrypted Communication Channel 
keys from Rainbow Technologies. * Multiple Algorithms 
¢ Configurable Memory 


¢ Field Updatable Memory 
¢ ADB Compliant 


es For Macintosh 


looking for a 


company to protect & PowerBooks 


and serve your 


As an Apple-certified third party developer, Rainbow 
was one of the first 

software protection 

developers to introduce 
a true Macintosh ADB 
port protection device. 
And with the 


introduction of the 





Macintosh software applications, call 






The small profile and high-tech 
modern design of the SentinelEve3' —_ SentinelEve3™, 
ensure that it is transparent to oper- 

ation of ADB devices. Rainbow continues 


on the company more software 
developers trust. Call 


Rainbow. And while 
to demonstrate 


you're at it, ask CALL 


about our low cost 800/ 852-8569 


; FOR YOUR FREE GUIDE 
SentinelEve3 TO SECURING SOFTWARE 


Simply put, the SentinelEve3 is the most technologi- . —_ a oe me 
cally advanced hardware key in the industry, period. Oa Sel nel 


Securing the future of software 


leadership by offering the next generation of Macintosh 


software solutions. 


Advanced in the areas that matter most to Apple Shown actual size 


CRAINBOW 


TECHNOLOGIE S 


9292 JERONIMO ROAD, IRVINE, CALIFORNIA 92718 @ 714/ 454-2100 @ fax 714/ 454-8557 @ AppleLink D3058 
RAINBOW LTD./U.K. 44 932 570066 & RAINBOW FRANCE 33 1 47 38 21 21 & RAINBOW GmbH/GERMANY 49 89 32 17 98 0 


© 1994 Rainbow Technologies, Inc. All product names are trademarks of their respective owners. 








New Release 


19 plot types 

Data analysis 

Interactive plot editing 

Batch processing options 

AY, CUD 51 8) Comm 0) Coyamnratavelonyas 

Multiple plots in same window 
Sub-scripting and super-scripting 
Number points limited by memory 
Update plot from calling application 
Display values in spreadsheet 
Templates to initialize plot characteristics } 
Set plot characteristics from application | 


[om Oo 


New MacForth Plus 4.2 


The Lantuage of Innovation 


MacForth Plus 4.2 


An interactive, multi-tasking, programming environment with: 


Royalty Free Turnkey Compiler = *High Level Graphics 

¢ Text Editor ¢ Toolbox Support 

¢Online Glossary Tool ¢ Extensive Documentation 

¢System 7 Compatibility ¢Upgrades from $39-$69 

°68020 Assembler & 68881/2 New $199 
Co-processor Support 


Optional 4..X Tools disk includes: 


¢DA & CDEV stand-alone examples 
¢ Object drawing program using 
Actels 


e Sibley Editor Enhancements 

eVersion 4.0 De-compiler 

¢Pop-Up MenuTools 

e Source code to YesNoCancel 
Stand alone 

¢$25 - MacForth 4.x Users 





Create Solution, Ine. 


4701 Randolph Road, Suite 12 
Rockville, MD 20852 
301-984-0262 or 1-800-FORTH-OK (orders) 
Fax: 301-770-1675 Applelink: CSI 
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" @ File Edit Settings Misc Analysis Windows 
3 ——<—<———— Untitled! 





Generate presentation 
quality plots with 
simple subroutine/procedure 
calls from your Fortran, 
Pascal, or C program 







For free demo and info contact 












SuperSoft 


498 E. Robin Rd. 
Orem, UT 84057 
(801) 225-4356 


Fax: (801) 226-6276 
Applelink: SuperSoft.UT 
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These features can be indispensable in a crisis. 

To help you move through your files easier, QUED/M lets 
you fold text: it lets you hide text in the window while still 
saving it in the file. For example, you could leave all the 
function declarations visible and hide the function bodies. 
When you're looking for a function you can scroll through the 
file quicker, find the function easier, and unfold the function 
body to edit it. The macro language in QUED/M might help you 
automate this task, but I haven’t tried it. 

The biggest drawback to QUED/M is its confusing 
interface. The menus are poorly organized, making it difficult to 
find commands. For example, the title of one menu is a number 
that constantly changes. It turns out that the number represents 
the amount of memory that QUED/M is currently consuming. So 
you might figure that the commands in this menu control 
memory management. In fact, only one command does. The 
rest balance parentheses and compare files. 

In general, QUED/M tends to be more powerful than 
BBEdit, but also more confusing. For example, take comparing 
files. In BBEdit, it takes one command. You choose the 
Compare Files command, select the files to compare, and click 
Compare. In QUED/M, it takes several steps. First, you have to 
choose the Differences Options command to set your options, 
some of which aren’t available in BBEdit, including what 
differences to ignore and how to display the comparison. Then 
you must make sure sure that the two files you want to 
compare are open in QUED/M and are in the two front most 
windows. (That’s how QUED/M knows which files to compare.) 
Finally, you choose 2-File Differences to perform the 
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Reduce your development time 
with QUEDM?’* text editor. 


Unlimited undos and redos. 

THINK C™ 6.0 integrated text editor, @ ) - 10 Clipboards that can be edited, saved, 
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Search and Replace through multiple 
unopened files. 





Powerful Search and Replace using GREP 
metacharacters and regular expressions. 


Extended Keyboard support - allows the key 
assignment of any Key ot the Apple® extended 
keyboard to any QUED/M menu command. 


reserve Foreign Resources - QUED/M allows 
ou to preserve all original resources of a file 


change bars; c 3 ven after editing and saving the file in QUED/M. 


into a new file m 44S many more features! wy 

change bars. In ac 

UNIX scripts fro Nisus 
sstions or order information Re edrhihca tian 


QUED/M is a registered trademark of 
Paragon Concepts, Inc. Other products 
are registered trademarks and trademark 
of their respective holders. 


all 800-922-2993 ext. 761 Solana Beach, CA 92075 


30 day money back guarantee on all orders. Fax (619) 481-6154 
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comparison. And of course all these commands are in the menu AVAILABILITY 
conveniently titled 240K (now it’s titled 239K, now it's 242K, BBEdit 2.5 is available from Bare Bones Software for $99. 
now it’s 238K, now — oh, never mind). In all fairness, though, THINK C, THINK Pascal, and Symantec C++ users can get it at 
the comparison facilities in QUED/M are quite flexible, and can the discounted price of $49. It requires System 6.0.7 or later and 
handle complex comparisons and automated merging. This 350K RAM. (To use BBEdit as an external editor for the THINK 
power/complexity might be for you if you are team Project Manager, you need System 7.) 
programming, and spend much time merging the work of two QUED/M 2.6 is available from most software distributors 
people into one source base. for a list price of $149. Until June 30th, 1994, it’s available 
directly from Nisus for $69.95. It requires System 6 or later and 
SUMMING UP 285K RAM. (To use QUED/M as an external editor for the 


The ability to choose a third-party editor certainly is a boon THINK Project Manager, you need System 7.) 
to the most particular of the power users, but many people will 
still prefer the THINK editor until Symantec adds some more FOR MORE INFORMATION 
support for third-party editors. In particular, the THINK Project BBEdit — Bare Bones Software, 1 Larkspur Way #4; Natick, MA 


Manager needs to ask editors to save files before compiling and 01760. Internet bbedit@world.std.com; Compuserve 

it needs to let editors display the definition of a symbol on 73051,3255; AppleLink BARE.BONES. 

which you Option-double-click. QUED/M - Nisus Software, 107 S. Cedros Ave., Solana Beach, 
When choosing a third-party editor, most people will find CA 92075-1900. (619) 481-1477. For the special price of 

that BBEdit offers everything they need and is easy to use. $69.95, call (800) 922-2993x761 or e-mail 

However, if you need features like unlimited undo, text folding, nisus.mktg@applelink.apple.com. 

sophisticated differencing/merging, and macros that don’t require 2 


a compiler, learning to use QUED/M could be best for you. 
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C/C++ without Master 








pen your eyes to Object Master’ the most 
innovative programming tool available on the 
market today. With its powerful editors and 
intuitive windows, Object Master gives you 
the unsurpassed freedom to develop code quickly 
and accurately. 


A Real Eye Opener 

Use Object Master’s unlimited number of browser 
windows to access code components and display 
their definitions, ready for editing. All changes you 
make in the browser windows are automatically 


cian displayed 
BSA throughout the 
environment, 


consistently 
ensuring current 
and accurate 
code. With the 
browser windows, 
you can also 
view a class list 

. displaying the 
hierarchical relationships between classes, and use 
pre-made templates to create classes and methods. 


Picture Perfect Code 

While the browser windows let you edit specific 
pieces of code, Object Master’s File editor gives 

you a full-file view of your code, allowing you to 
quickly perform universal edits. 

To help you identify important pieces of code 
easily, Object Master color codes and formats 
language elements. With a single keystroke, 
Object Master will look up parameters for methods 
or functions contained in the project and paste 
them directly into your source code. 





improved Insight 

Don't worry about the physical location of your 
code—Object Master parses all files and maintains 
a data dictionary of project components. The 
dynamic environment updates your entire project 
automatically as you edit without compilation! 
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True browser windows let you see code like never before. 


Object Master provides you with all the editing 
and navigational capabilities you require to write 
code productively. For example, the Class Tree 
window graphically displays your project’s class 
hierarchy and allows you to expand and collapse 
“branches” and open multiple windows displaying 
specific code components. 


Power Macintosh Support 
ACT offers two versions of this outstanding 
programming tool: Object Master and 

Object Master UNIVERSAL. Both run on the 
traditional 68K-based Macintosh computer and 
the new Power Macintosh, taking full advantage 
of the features of each platform. 


Introducing a powerful new way of looking at code development. 


Object Master supports C and C++ and works 
seamlessly with Symantec's THINK Project 
Manager and Metrowerk’s CodeWarrior. Separate 
versions are available for the 68K-based Macintosh 
and the new Power Macintosh computers. 

Object Master UNIVERSAL supports C, C++, 
Pascal, Modula-2, and all major compilation 
systems. It can be installed on both the 68K-based 
Macintosh and the new Power Macintosh. 





“+ Object Master pays for itself in a week, even at 
suggested retail price.” —Macworld Magazine 


See Object Master for Yourself 
Call (800) 384-0010, and we'll send you a free 
demo disk of Object Master—because seeing 
really is believing. 





ACI US Inc. 20883 Stevens Creek Blvd., Cupertino, CA 95014 
Tel. 1 408 252 4444. Fax 1 408 252 0831. AppleLink D4444 


©1994 ACI US, Inc. All product or service names mentioned herein are 
trademarks of their respective owners. Quote reprinted courtesy of 
Macworld Communications, 501 Second Street, San Francisco, CA. 94107 
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Q. J changed a library in my project, and now I get link errors that say __noMethod 
and __noObject are undefined. Why? 


A. These 2 functions are called from oopsDebug or oopsDebug++. The libraries call 
—_noMethod when a message lookup fails, and __noObject when a message is sent toa 
bad object pointer or handle. These functions, declared in oops.h, allow your 
application to catch potentially fatal errors, and take the appropriate action. You must 
provide the code which defines the functions. For example: 


void __noMethod(void) { printf("Method lookup failed\n"); exit(1); } 


Q. My project is using classes based on Pascal Objects. Are there any advantages to 
changing it to use pointer based objects? 


A. Yes. Pointer based objects require less special treatment. Since they are not 
handles, they will never move, and you don't need to worry about locking and 
unlocking them. Also, you will no longer need to keep track of when you are using a 
pointer, and when you are using a handle, so dereferencing becomes less of an issue. 
Another reason is that Pascal objects are not part of the C++ standard, which is a 
problem if you want to port your code to another platform. 


Q. What are the advantages of moving the application I wrote with TCL 1.1.3 up to TCL 2.0? 


A. First, TCL 2.0 uses pointer based objects instead of Pascal Objects. You can now 
use all of the nice features of C++ like multiple inheritance. Also, there are new classes 
that make it relatively easy to add features like scriptability to your application. 


Q. I updated to C++ 7.0. Now I am getting warnings like the following (in this case 
while precompiling TCL #includes.cpp): File <Exceptions.h>; Line 71; While compiling 
<TCL #includes.cb> Warning: unrecognized pragma. What's the problem? 


A. The behavior of the 7.0 C++ translator in response to unknown pragmas has 
changed. In old versions, unrecognized pragmas were simply ignored. Now, they are 
flagged by warnings. The guilty pragma: #pragma nooptimize(CatchException) was 
unrecognized in C++ 6.0.x, but the compiler didn’t complain. It is safe to ignore the 
warning. You can disable the warnings, if you like, by going to Edit:Options:symantec 
C++.,,.: Warning Messages and unchecking the Unrecognized pragma box. 


Q. 1 bad to change some of my #pragma statements in order to fix link errors for my 
templates after I upgraded to C++ 7.0. For instance, the 6.0.x Vector Project gave me errors 


like this: undefined: operator <<(ostream&,vector<char>&) (main.cp) Why did this change? 


A. Templates at 6.0.x could cause problems because the response to #pragma template 
TemplateName<type> was to instantiate every method in the TemplateName class. The 
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Evolve or Perish 





DataPak Software hasn’t ignored this rule of survival and 
we realize the time for simply “refining” existing technologies 






has passed. We designed our new line of tools with a clean 






slate and created something revolutionary—PAIGE™. 






PAIGE is an advanced open architecture document 






processor with unlimited uses. Whether you choose object or 






source code in C, PAIGE allows you to quickly build: 






¢ Simple Text Processing ¢ Report Generators 

¢ Advanced Word Processing * E-Mail & Comm. Tools 
* Page Layout Programs ¢ Multimedia Programs 

¢ Hypertext Tools ¢ Programming Editors 












For the first time, programmers have complete control of 
all data elements (text, graphics, containers, Quicktime Video, 






embedded objects, voice/sound, etc.) and how they are 






incorporated into the documents their software produces. 






PAIGE was specifically developed to meet a wide range 






of developer's needs. It uses no globals, breaks the 32K 






barrier, implements virtual memory and is available in native 
PowerPC, Macintosh and Windows versions. PAIGE 
supports most compilers, development systems and class 
libraries—and is, of course, ROYALTY FREE. 











“PAIGE enables us to develop open architecture, multi-media, 
groupware and knowledge-based document production systems 
for the Macintosh. We are also able to port these across 







multiple platforms, and achieve new levels of integration with 
other applications’—Dr. Brian Gaines, Univ. of Calgary 







For complete PAIGE technical and pricing summaries 
please contact us at 1-800-327-6703. Product demonstration 






software can also be accessed through most major communi- 






cation bulletin boards and services. 





DataPak Software Inc. * 9317 NE Hwy 99 #G « Vancouver, WA 98665 
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Internet: datapak1@aol.com * AOL: DATAPAK1 « CIS: 76424,3027 
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expansion of large templates could result in code that would 
exceed the 32K segment size, and there was no way short of 
redesigning the project to get around it. In the 6.0.x Vector Project, 
for example, the statement: #pragma template vector<char> in the 
file vector<char>.cp caused the vector class for char, as well as the 
<< operator and other methods, to be instantiated. In 7.0, you 
have to tell the compiler exactly where to instantiate the class and 
each of its methods. That’s why you need the line: #pragma 
template operator <<(ostream&, vector<char>&) to fix the link 
error. The increased control afforded by this change solves the 
segment size problem by allowing you to instantiate the class and 
its methods in different files in different segments. In general, the 
changes give the programmer more flexibility in generating the 
template instantiations. 


Q. J have several projects that share the same resources. Is there 
any way to avoid having to edit the <ProjectName>.rsrc for each 
project whenever I want to change the resources? 


A. Yes. The Resource Copier translator exists for that purpose. 
What it does is takes the contents of each .rsrc file in the project 
window and, when you bring the project up to date, updates 
the <ProjectName>.rsrc by copying any new or changed 
resources into that file. To share some resources between 
ProjectA and ProjectB, you could create a SharedResources.rsrc 
file, and add that file to each project. When you bring ProjectA 
up to date, the resources in SharedResources.rsrc will be copied 
into ProjectA.rsrc. ProjectB will work the same way. When you 
want to change the resources, run ResEdit on 
SharedResources.rsrc instead of ProjectA.rsrc or ProjectB.rsrc. 


Q. Can I mix .rsrc and .r files in the same project? 


A. Certainly. THINK Rez is just like the Resource Copier in its 
treatment of the <ProjectName>.rsrc file. The changes to any .r 
file in a project will be copied into the <ProjectName>.rsrc file 
when you bring the project up to date. It is okay to mix .r and 
src files in the same project, as long as the resource types and 
numbers are unique. 


Q. Are there any online sources for patches? 
A. Yes. Here is the list: 


AppleLink: To find patches, follow the path: Support:Third 
Parties:Third Parties (P-Z):Symantec Solutions:Software Updates 
and Solutions:Think C/Symantec C++ Updates 

CompuServe: To find patches: GO SYMDEVTOOLS, and 
BROWSE through library 2 for C patches, library 11 for C++ 
patches. 
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CMaster 2.0 installs inside of THINK C 5/6/7 and Symantec C++ 
__| For Macintosh, and enhances the environment. No new editor 
| to learn—CMaster builds on what Symantec has already 
provided. See for yourself why programmers from around the 
world use CMaster & MacUser gave CMaster a 5-mouse rating. 







CMaster 2.0 incorporates hundreds of features asked for by real 
programmers like yourself. Future ads will each hilite one special 
aspect CMaster 2.0 brings to the THINK editor. Call or email for 

more information. 








The Fast, Efficient Way to Edit THINK Code 





User Quote of the Month: "This is GREAT. 
Working without CMaster is like working with a hammer & chisel instead of a word processor” 


@ VISUAL ENVIRONMENT 

You define the text window environment. Access CMaster features from icon or words in the window title bar or the 
horizontal scroll bar, or via MacDraw™ like icons on the left or top of the window. Choose their color and the text & 
background colors. See the cursor's line and column in a pane, and the current function in another. Split a window into 
two parts and edit in either part. Use the GoBack Menu to jump backwards and forwards to previous editing positons 
even if in another window. Use the Files menu to access included files even if the file hasn't compiled, or all header/text 
files in configurable directories. See all text files in the font of your choice without having to modify each file. 


CMASTER PACKAGE ONLY $129.95" 

30 DAY MONEY-BACK GUARANTEE 
Jersey Scientific, Inc 291 Springfield Av Suite 201, Berkeley Heights NJ 07922 TEL: 212.736.0406 FAX: 908.464.3458 
APPLELINK: JERSCI + CIS: 70400,3361 * MASTERCARD, VISA, CHECKS, AND CORPORATE POs ACCEPTED. 
$4 S&H US Post ($10 UPS BLUE, ~$14 Intl) * E-mail orders accepted— send VS/MC number, exp. date, and ship address 
aiinis t(Upgrades from Version 1: purchased before Jan 1, 1994 only $49.95—since then only $10; plus shipping. 


THINK C is a trademark of the Symantec Corporation. CMaster is a registered trademark of Jersey Scientific, Inc. 































Symantec BBS: Call 503-484-6669 @9600 or 503-484-6699 
@2400. 


America Online: To find patches: keyword ‘Symantec’, click as C rs | C ; 4 


on Software Library 


Internet (FTP): anonymous ftp to sumex-aim.stanford.edu. Stuck with Pascal source code? 


The path to patches is info-mac/lang 


Want to move to C++? 


Q. I can't get the TPM to automatically start up THINK 


Reference, even though I put “THINK Reference alias” into the OP2CPlus is a Macintosh tool for converting 
Tools folder. Why doesn't this work? Object Pascal source code to C++ source code. It 
has already been used to translate hundreds of 
A. Items in the Tools folder should be the exact name of the ' thousands of lines of Object Pascal to C++. 
program you wish to use. You must edit “THINK Reference _ . _ 
alias” to be “THINK Reference”. To use another program like Ease your transition to Bedrock or PowerPC 
ToolServer, put in “ToolServer”, not “ToolServer alias.” ———r—_U : 
Q Convert in days instead of months 
Q. The sizeof operator doesn’t work. The following statement QO Generates C++ classes 
prints 0: printf("%d\n" sizeofCint); QQ) Works with MacApp 2 or 3 
es tee wedk ees Q Translates Think or MPW Pascal 
. 5 that siz t k. : 
ee _ QFull ANSI C source code included 
works: printf("%ld\n",sizeof(int)); 
Q) Just $895 
2 | Graphic Magic Inc, 180 Seventh Ave, Suite 201 
om, Santa Cruz CA 95062 Tel (408) 464 1949 


Fax (408) 464 0731 AppleLink GRAPHICMAGIC 
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i The Relational Database System 





Ma 





& 
isa is a true relational database management system for 
C/C++ application development. dtF features SQL, full 
transaction control, error recovery and client-server 


e 
architecture. 
hi royalty free... Tai true client server... 
Create and distribute as many applications dtF client server architecture insures 
as you like, royalty free! efficient use of network bandwidth and 
optimum data security. dtF will not bog 
down your network like systems that use 
ti fast... file sharing. = 


When it comes to performance dtF is ina ; 

class all its own. dtF utilizes a proprietary single user... 

query optimization and caching scheme to Client server applications will not be 
obtain unparalleled performance. stranded on the LAN. Relink your 
application with dtF single user and you 
will have a no compromises high 


performance stand alone. 
dtF was developed by Macintosh developers for 
hi: for you! 








is efficient... 


Macintosh developers. Applications developed with 
dtF will be compact in both single and multi user 


form. Perfect RDBMS for Powerbook applications. For maximum performance, realistic licensing 
policy and reasonable pricing you can not beat dtF. 
No static preprocessors, only a dynamic, fully 

Thi. SOL... featured SQL. The C/C++ API is identical and 





fully portable over all supported platforms in both 
single and multi-user environments. dtF is ideal 
for use with TCL and MacApp. 


dtF supports an efficient subset of ISO 
standard SQL that is optimized for speed 
and ease of use. 


hi: ae Pariatiorms and Compilers... 


Available for Macintosh System 7.x and 
native Power PC. dtF Server requires a 
68020 or better. MPW C/C++ and 
Symantec C/C++ 5.x and higher are both 





Full transaction control and error recovery 
guarantee maximum data protection even after 
sudden system crashes. dtF databases are 
compressed and encrypted to protect against 





all unauthorized access, even disk editors. supported. 
dtF Evaluation $129 
S easy... dtF Macintosh SDK $695 
Integrated data dictionary, security, dtF LAN Macintosh SDk* $1595 
automatic index selection, query dtF Server $1295 


optimization, deadlock detection and error 
recovery allow you concentrate on your 
application. 


SA 2A 2 Ge ee ee eee eee eee re] 
dtF Americas, Inc. 

12545 Olive Blvd, Suite 130 

St. Louis, MO 63141 
800.DTF.1790 Voice 
314.530.1697 Fax 

AppleLink: DTF.AMERICA 





dtF is also available for DOS, Windows, OS/2 and several flavors of UNIX. 





By Mike Scanlin, MacTech Magazine Regular Contributing Author 


FACTORING 

Being able to factor quickly is an 
important part of breaking secret codes, 
I mean, writing cool Mac games. This 
month’s challenge, therefore, is to factor 
a 64-bit number into the two primes that 
were multiplied together to produce it. 

The prototype of the function you 
write is: 
void Factor64(lowHalf, highHalf 

primelPtr, prime2Ptr) 

unsigned long lowHalf; 
unsigned long highHalf; 


unsigned long *primelPtr; 
unsigned long *prime2Ptr; 


highHalf and lowHalf are the 
64-bit input number split into two pieces 
(bit zero of lowHalf is bit 0 of the 
input number and bit 31 of highHalf 
is bit 63 of the input number). The input 
number is guaranteed to be the product 
of two primes, each of which is 32 bits 
or less. Your routine will store one 
prime at *primelPtr and the other 
one at *prime2Ptr (in either order). 

Remember, solutions must be in C to 
qualify for entry into the Challenge but 
assembly versions might get mentioned if 
they're wicked fast. Also, if anyone has a 
nice routine for factoring even larger 
numbers (like, say, 256-bit numbers) into 


composite primes and wouldn’t mind 
sharing it with MacTech readers then send 
it on in. The best one might get published 
along with the winning solution. 


TWO MONTHS AGO WINNER 


The competition for the Swap 
Blocks challenge was unusually tough. 
There were several very high quality 
entries. Congratulations to Bill Karsh 
(Chicago, IL) for winning with the 
fastest entry. It was only last month that 
I declared Bob Boonstra (Westford, 
MA) the Programmer Challenge 
Champion for having the most number 
of first place showings but now he and 
Bill are tied for that elusive title (with 
three wins each). Jorg Brown (San 
Francisco, CA) deserves praise for his 
second place showing. His code size 
was just over half of Bill’s winning 
solution and was nearly as fast. 

Here are the code sizes and times 
for two different tests. The first time test 
was for random size inputs (according 
to the distribution stated in the 
problem). The second time test was for 
blocks that were roughly, but not 
exactly, equal in size (again, with the 
given distributions but with both sizes 





coming from the same size category). 
Numbers in parens after a person’s 
name indicate how many times that 
person has finished in the top 5 places 
of all previous Programmer Challenges, 
not including this one: 


Name time1 time2 code size 
Bill Karsh (3) 170 219 642 
Jorg Brown 174 242 306 
Jim Lloyd 209 408 1642 
Lorn Olsen Vin 350 670 
Ted Krovetz 243 247 88 


sbi cdi en RP eT et (Sees ee 
Stepan Riha (6) 243 347 452 
Bob Boonstra (8) 247 443 480 











Jeffry Spain 248 397 234 
Greg Landweber (1) 264 491 300 
Martin Weiss 281 601 210 
Christopher Suley 299 321 110 
Dave Darrah 299 681 284 
Ernst Munter 315 414 632 
Xan Gregg 340 1260 484 
Michael Anderson 359 942 156 
Allen Stenger (5) 393 436 156 
Michael Panchenko 409 465 82 
Danny Stevenson 449 583 424 
Eric Bennett 493 1478 284 
Arnold Woodworth — 595 729 206 
Bob Boonstra 212 418 4()0 
(assembly) 








(exc 10s n. “How to Contact Xplain Corporation." 
- However, you may call any routine in the Macintosh toolbox you want \.€., : ch Magazine reserves the right to publish any solution entered in 
doesn’t matter if you use NewPtr instead of malloc). All entries will be tested the Programming Challenge of the Month. Authors grant MacTech Magazine 
with the FPU and 68020 flags turned off in THINK C. When timing routines, the non-exclusive right to publish entries without limitation upon submission 
the latest version of THINK C will be used (with ANSI Settings plus “Honor of each entry. Copyrights for the code are retained by the author. 
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Database Engine 
For Macintosh 


ViperBase 





ViperBase™ and ViperBaselI™ are fast and easy to use 
database development engines, designed as C++ object 
frameworks. Includes libraries for Pascal and C/C++, for use 
with MPW, Think C 6.0, and Metrowerks development systems. 


ViperBase™ includes: 
¢ Unlimited Variable Length Records 
* 6 Easy to Learn Methods 
* Extremely Fast and Efficient 
¢ Upgradeable to ViperBaseII™ 
© $5900 


ViperBaselI™ includes ViperBase™ plus: 
¢ Multiple Indices 
* Variable Length Keys 
e $119% 


Use ViperBase™ or ViperBaselII™ to save time and money over 
developing in-house, or buying expensive imitations. Includes 
comprehensive examples and sample applications. No Royalties. 
Free tech-support through AppleLink. 30-Day Money Back 
Guarantee. 


Viper 


Development 


ee a une ree en ee ee ees 





* Call or write: 
Viper Development 
P.O. Box 1137 
Layton, UT 84041-6137 
(801) 776-0436 

_ AppleLink:VIPERDEV 





Se 








The SwapBytes problem is really a multi-byte rotate 
problem. Think about it this way: If you had a 32-bit register 
and you wanted to swap the low 7 bits with the upper 25 bits 
you could just rotate it 7 bit positions to the right. The rotate 
instruction is like a SwapBits operation where size1 + size2 
always equals 32. 

Almost everyone who entered used a variant of this 
observation. The fifth place entry by Ted Krovetz (Santa Cruz, 
CA) illustrates it nicely: 
void SwapBlocks (void *pl, void *p2, 


void *swapPtr, ulong sizel, 
ulong size2, ulong swapSize) 


long *1lpl = (long *)pl; 
long *lp2 = (long *)p2; 
ulong sl = sizel >> 2; 


ulong s2 = size2 >> 2; 
ulong count; 
long temp, *temppl, *tempp2; 


do { 
a eo ot Ge pg) a 
Count sl: 
temppl = lpl; 
S2 == sl: 
tempp2 = lp2 + s2; 
} 
else { 
Count = S72; 
temppl = l1pl; 
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tempp2 = l1p2; 
lp] = 823 
ceo 62 

} 

do { 
temp = *temppl; 
*(temppl+t+) = *tempp2; 
*(tempp2t+) = temp; 

} while (--count); 

} while (sl); 
} 





Because Bill’s winning solution is so general purpose and 
macro-ized it is not the easiest code to read (although | 
commend his generality in making a useful piece of reusable 
and portable code). He has compile-time flags that let you build 
a large fast version (over 600 bytes, which was the version 
timed) or a small slower version (less than 100 bytes). And you 
can optionally change the 4 byte alignment assumption into a 2 
byte or 1 byte alignment assumption (by redefining AtomSize). 

I used Think C’s preprocessor command to see what all 
those #defines would boil down to. The core swap code for 
those cases where you can’t use the temporary swap space 
(cause it’s too small) ends up looking like this: 


switch( (short)q ) { 


case 0: 
while( --nS ) { 
q = “ph; 
Digee= sph. 
TO: Bogs 
ease 7% 
q = "pl 
“DLT =sF ORs 
Dae gy 
case 6: 
= ay) 
ple 2 * ORs 
“paar = Ge 
case 5: 
q = “pl; 
*pLtt+ = *pR 
“pRtt = q; 
case 4: 
q = “pL 
‘DLAI Es* pas 
“PRtT = q; 
case 3: 
q = “ph; 
“pLit. = \ aR: 
“pRtt = q; 
case 2: 
q = *pL 
"pur _ ‘DK: 
"DRT =o 
case l: 
q = “ph; 
"plat = * poke 
*pR++ = q: 
} /* end while */ 


}; /* end switch */ 


This illustrates some interesting loop unrolling syntax that’s 
possible in C. As the code shows, it’s legal to spread a while 
statement over several case labels in a switch statement. 
Which nicely solves the problem of “How do you handle the 
remainder?” when you unroll a loop 8 times. In this example nS 
is the number of times to swap divided by 8 and q is 
numTimesToSwap mod 8. So if numTimesToSwap is 10 then 
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q is 2 and nS is 1. When the switch statement is executed it 
will branch to case 2 which does 2 swaps and then loops 
back to the top of the while loop. It runs through one set of 8 
swaps and then stops. Pretty cool syntax. 

Here’s Bill’s winning solution: 


SWAPBLOCKS 
Response to Apr 94 MacTech Programmer's Challenge. 


by Bill Karsh 


Object: Exchange contents of two adjacent memory blocks. 


Redirection: This is an interesting problem, but what would 
make this guy really useful? As stated, the blocks for the 
challenge are 4i bytes long and start on 4j aligned addresses. 
These are special circumstances which apply to Memory 
Manager blocks, and then, only on 68020 or later cpu's. 
Memory blocks on the 68000 are merely even aligned and even 
length. Further, this could be a word processor tool for 
swapping runs of bytes, but we would have to relax the 
alignment and size restrictions even further to arbitrary address 
and length since we would almost always be pointing to 
characters interior to a handle. 

I have written the routine to give its best performance, 
subject to a specified minimum enforced alignment and atom size 
(smallest unit to move). This is controlled at compile time by: 


typedef long Atom, forlen = 4i, addr = 4j, 
typedef short Atom, forlen = 2i, addr = 2j, 
typedef Byte Atom, forlen = any, addr = any. 


Note — due to an ancient law of portability, preprocessor 
directives are not allowed to compare enums, types, sizeofQs 
or anything else that has machine dependency hidden in it. 
This means you have to #define the AtomSize manually. 
This is needed to select the proper performance crossover 
points for that type. 

But wait there’s more... You might not tolerate a 644 byte 
dedicated word swapper in your text editor, but a 96 byte one 
might fit. We handle that. 

You can tailor the routine to your requirements for 
execution speed:vs. code size by setting the JobMode constant 
according to this table: 


JobMode __ Buffers MonsterCopies | MonsterSwaps 
Smallest No No No 
Small No No Yes 
Fast Yes No Yes 
Fastest Yes Yes Yes 

— billKarsh 
JUNE 1994 


NOW YOU CAN ADD MOVIE-LIKE 


C1 VN od a | Om 1 ol el 4 OR 


TO YOUR MAC APPLICATIONS 








“WIPES ¢ DISSOLVES * TRANSITIONS & MORE 


Already part of a new multimedia authoring tool, 
Ariel Publishing's latest release of "QDFx", includes 
a library of 20 graphic effects you can apply to your 
Mac applications and without the overhead of includ- 
ing a quick time movie. 


It's fast, it's small, it's royalty free and only... 


$69.95 


System 7 compatible, 32-bit clean, C source code available 
(sold separately). Native Power PC version available 
by June 15, 1994 






P.O. Box 398 
Pateros, WA 98846-0398 

Phone: (509) 923-2249 

E-mail: America Online - (ARIELPUB1), 
GEnie - (InsideBasic), 

CIS - (71441,2262) 





To order by mail: 


Visa/MC and purchase orders cheerfully accepted. 


#tpragma options( honor_register, !assign_registers ) 








#defines 
ttdefine Smallest 0 
define Small 1 
4define Fast 2 
define Fastest 3 
User Selectable Parameters 
ttdefine JobMode Fastest 


define Verify_pl_LowerThan_p2 0 


Sorry, you must #define your chosen Atom’s size by hand. 
The preprocessor won't accept sizeof operators. Yuck! The 
XOvers below vary according to this size, so we have to know it. 


typedef long Atom; 
ftdefine AtomSize 4 





if JobMode >= Fast 

#t define UseBuffer 1 
fendif 

if JobMode == Fastest 

# define MonsterCopy 1 


fendif 

#if JobMode >= Small 

# define MonsterSwap 1 
#fendif 
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THE NATIONAL CONFERENCE & EXPOSITION 
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Object Expo’94 





June 6-10, 1994 ¢ NY Hilton, New York City 


Join more than 5,000 of your colleagues at the object industry’ 
best-attended conference and exhibition, Object Expo, now i 
its 6th successful year! With an all new technical program geare 
for both the new and experienced users of object technolo 
Object Expo will guide you to new levels of productivity—help 
ing you infuse objects into your current software projects. 





e All New Technical 
Program 
This world-class technical 
program represents the latest 
breakthrough strategies and 
hot topics, brought to you by 
a prestigious faculty. 


e Create Your Own 
Schedule 


Choose from several 
concurrent tracks— 
Fundamentals, C++, Business 
Strategies, Analysis & Design, 
Databases, Smalltalk and 
Distributed Object 
Technology—over 70 classes 
to create your own 
individualized schedule. 


Executive Briefing 

This high-powered, 
condensed session gives busy 
executives distilled advice from 
the world’s leading experts. 
Find out what you really need 
to know to implement object 
technology in your company. 
Seating is limited. 


Two Floors of 
Exhibitions 

Meet the leading industry 
vendors, who are shaping the 
future of the industry. Test and 
demo an entire spectrum of 
the latest OT products and 
services on display at one time. 


Walk-In Clinic with 

the Speakers 

Tap into the minds of the 
leading thinkers behind the 
technology. On the Exhibit Floor. 


Delegate Idea 
Exchange 

Swap tips and ideas with your 
colleagues. On the Exhibit Floor. 


Special Events 

Discover what's next from the 
largest vendors in Product 
Education Sessions, 
Participate in Birds-Of-A- 
Feather sessions, association 
and industry group meetings, 
and more! 


Atelier Research ¢ BSO Tasking ¢ Cadre ¢ CenterLine e Computer Associates 
DEC ¢ Digitalk ¢ Easel/Enfin « Expersoft ¢ General Electric e Harlequin 
Hewlett-Packard ¢ IBM ¢ ISE ¢ John Wiley & Sons ¢ James Martin Insight wer, 407. il; 
Knowledge Systems Corp. ¢ Liant ¢ Lucid ¢ MetaWare ¢ Object Int'l Witdl YOULI 
Palladio Software ¢ ParcPlace Systems e Persistence Software e Poet Software 























Popkin Software ¢ Prentice Hall ¢ Project Technology ¢ Pure Software e Rational ’ Re ene peeking your business with objects 
Rogue Wave Software ¢ Semaphore  Servio © SIGS Publications ¢ Syrinx ¢ Planning for reuse 
Take Five Software * WATCOM e Versant © Zinc Software ® Designing and managing class libraries 
pees ee “ ¢ Exception handling in C++ 
1 ® Objectifying real time systems 
Sear aan ean e Advanced Smalltalk 
i ecnnica onrerence xecultive brieting I ; : ‘ : a 
(J Free Exhibits Pass 5J Exhibiting e Finding business objects using CRC cards 
¢ Smoothing the transition to OT 
@ Writing an OOP that works 
ah l : 
I ® Integrating OT into legacy code 
r 
| Company | ® Getting started with objects 
! | ® Moving from COBOL to object orientation oe 
| Addres 
; e Advanced O-O A & D techniques OBJECT 
I i ; ; ; 
I ® Using persistent objects 
I ® Maximizing organization reuse C£tReP0n 
; City | ¢ Valuable lessons from large-scale projects JOURNAL OF 
| OBJECT- ORIENTED 
i State Zip ! ¢ Comparing A & D methods and languages Programming 
] ei ; 
! r ® Writing high-performance C++ and 
! Phone Smalltalk code a — 
Fax e Successfully implementing an OODBMS st 
H ; ; 

1 | ® Using distributed object technology 

Send coupon to: : 
I e Effective testing and debugging techniques PRESENTED BY 
| Object Expo, 588 Broadway, Suite 604, New York, NY 10012! 3 fy ewes : oe 
! Phone 212.274.9135 Fax 212.274.0899  oemT 1 — ® Measuring and comparing O-O productivity WSIGS 





CONFERENCES 


and much more! 
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define 


Lo3B Ox00ffff(L 








#if AtomSize == 

# define FwdXOver 144 
# define BckXOver 120 
## define SwpXOver 4d 
felif AtomSize == 2 

+ define FwdXOver 48 
## define BckXOver 44 
if define SwpXOver 32 
felse 

# define FwdXOver 24 
# define BckXOver 20 
# define SwpXOver 12 
fendif 








define FwdOp 
“datt+ = “stare 





#fdefine BckOp 
eided Sige 





+#define SwpOp 
q = “ph; 
Spit. = 2 phi 
Spat. = 'q 


ee pe Ge. 





#fdefine Cases3_1( op ) 
case 3: Op; 
case 2: Op; 
case l: op 


Cases3_ 1 


\ 
\ 
\ 





#fdefine Cases7_1( op ) 
case 7: Op; 
case 6: Op; 
case 5: Op; 
case 4: Op; 
Cases3_1( op ) 


Cases7_1 


ee Se sO eet nl 





define CalcPasses( bits ) 
nS /= sizeof (Atom) ; 
q=nS & ((1 « bits) - 1); 
nS >>= bits; 
+4+nS 


CalcPasses 


ee a 





define Monster( op, cases ) 
switch( (short)q ) { 
case 0: 
while( --nS ) { 
Op; 
cases( op ); 


Monster 


\ 

\ 
\ 
\ 
\ 
\ 
\ 





#if MonsterCopy == 1 
#tdefine CopyInc( dst, src, n ) 
OC ails i 
if( nS > FwdXOver ) { 
_Copylnc ( 
(Atom*) (dst), (Atom*) (src), nS ); 
else {| 
pL 
pR 


(Atom*) (dst) ; 
(Atom*) (src) ; 


do { *pL+t = *pRt+; } while(nS-=sizeof (Atom) ) ; 


} 
ftelse 
define 
nS ‘ti; 
pL = (Atom*) (dst); 


CopyInc( dst, sre, n ) 


June 1994 


\ 
\ 
\ 
\ 
\ 
\ 
\ 
\ 
\ 
\ 


Copylnc 


See 











Richey Software Training provides 
professional, customized programming 
seminars and industry consulting. 


Rich content & hands-on lab 
exercises shorten your learning curve. 
On-site training is convenient — your 
team eliminates expensive travel costs 
and consuming down-time. 


ee Professional training & consultancy 99 
that really hits the mark. 


Call today to find out how Richey 
Software Training delivers professional 
seminars and consulting nationwide. 








MAC 
SEMINARS 


-C& C++ 
-OOP 
-MacApp 
- PowerPC 


-MPW 
-System 7 

- Debugging 
-SourceBug 
-SADE 
-TMON 





Training Mac Programmers Since 1986 


707-869-2836 


AppleLink: RICHEY.SOFT 


INTERNET: 70413.2710@compuserve.com 
P.O. BOX 1809, GUERNEVILLE, CA 95446-1809 


© 1994 Richey Software Training. All trademarks or registered trademarks are 
the property of their respective owners. Specifications subject to change 
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pR = (Atom*) (sre); \ 
do: Opler = SpRtr; )} while (nS-=sizeof (Atom) ) 
endif 
CopyDec 
#if MonsterCopy == 
define CopyDec( dst, src, n ) \ 
nS = ‘n; \ 
pR = (Atom*) ((Byte*) (dst) + nS); \ 
pL = (Atom*) ((Byte*) (src) + nS); \ 
if( nS > BcekXOver ) { \ 
CalcPasses( 2 ); \ 
Monster( BckOp, Cases3_l ); ; 
} 
else { \ 
do { BckOp; } while(nS-=sizeof (Atom) ) ; \ 
} 
ffelse 
define CopyDec( dst, src, n ) \ 
nS =n; \ 
pR = (Atom*) ((Byte*) (dst) + nS); \ 
pL = (Atom*) ((Byte*) (src) + nS); \ 
do { BcekOp; } while(nS-=sizeof (Atom) ) 
#fendif 
Swap 
#if MonsterSwap == 
define Swap \ 
if( nS > SwpXOver ) { \ 
CalcPasses( 3 ); \ 
Monster( SwpOp, Cases7_l ); \ 
} 
else { \ 
do { SwpOp; } while(nS-=sizeof (Atom) ) ; \ 


} 
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titles 
variable height rows 
variable width columns 
default titles of letters or numbers 
move / copy row/column 
sort rows / columns 
resize column / row 
“LDEF-like” custom 
drawing support 
in use since early ’92 





StoneTablet Publishing 

P.O. Box 12665 

Portland, OR 97212 

(503) 287-3424 

CIS: 70303,2546 
70303.2546 @ compuserve.com 






StoneTable ™ a drop-in replacement library for the List Manager 





Father |Joe Smith 


Misti Sue Srnith 1436 Miller Cre —— scroll cell text 


All the functions of the List Manager 
plus support for those listed above and more. 
Simple conversion from the List Manager. 












edit cell / title in place 
different font per cell 
1 ieee appli. defined cell validation 
+, OT | - = PASC Slunane 
| fore / back color per cell 


#3 
Portland, OR 97232 Se ee eel 
> 32K non-text per cell 

























San Rafael, amy 






Libraries available for 

Think C, Think Pascal, MPW C $150 each 
International shipping (US Airmail) $10 
Payment only by check in US$ 

No royalty fees for applications 
TCL/MacApp not required 


















#else 
define Swap 

do { SwpOp; } while(nS-=sizeof (Atom) ) 
endif 





define MacroMania true 








#if JobMode == Fastest 





_Copylnc 


Copy specified number of Bytes from src to dst. Addresses are 


incremented, so src and dst can overlap iff dst <= sre. 
static void _CopyInc ( 

register Atom "dst, 

register const Atom Tere. 

register unsigned long nS ) 

Short iq, pad: 


CalcPasses( 3 ); 
Monster( FwdOp, Cases7_1 ); 


} 
fendif 





SwapBlocks 
void SwapBlocks( 
void fal, 
void "Oey 
void *swapPtr, 


unsigned long sizel, 
unsigned long size2, 
unsigned long swapSize ) 


register Atom ‘pL, *pR, *p0; 
regteter long nL, nR, nS, q: 


Boolean done; 

short pad; 

if( !(nL = sizel) || ! (mR = size2) ) return; 
pO = pl 
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If you can safely assume that p1 is always lower or same 
as p2, define Verify_pl_LowerThan_p2 = 0 (the #if 
section is not necessary). 

If the “1” and “2” in p1 and p2 are simply labels, indicating 
nothing about position in memory of the blocks, then you must 
order them by activating the #if section. Define 
Verify_pl_LowerThan_p2 = 1. 

Ordering means comparing addresses, which treats them as 
32-bit numbers, no matter the current cpu addressing mode. If 
GetMMUMode returns true, we are in 32-bit mode — all 32-bits 
are significant. 

In 24-bit mode, when the cpu uses an address to load or 
store something, it totally ignores the high-byte of the address. 
The high-byte may be random garbage. In this mode we 
suppress any garbage before comparing by masking it to zero. 


#if Verify_pl_LowerThan_p2 == 1 


pR.= p23 


if( !GetMMUMode() ) { 
pO = (Atom*) ((long) pO & Lo3B); 
pR = (Atom*) ((long)pR & Lo3B); 


—" 


bBo Ca of ao Ce 
qo-= (hong) p0s 
pO = pR; 
p2 = (Aton) ¢ 
c aibocee cl 
nh. = nk: 
HR = "Gs 

} 

ffendif 


First, make use of buffer if we can. This is faster in most 
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cases. A notable exception is equal size case which is best done 
in situ (let drop through). 

Compare only the smaller size with buffer. If left is smaller, 
we can use post-increment addressing which is the faster mode. 
If right is smaller, use pre-decrement mode. We omit seeing if 
right-smaller will work with post-increment mode (if left also 
fits buffer). Preflighting overhead swallows us up very quickly. 





Buffer? 
#if UseBuffer == 1 


if( nL < nR ) { 
if( nL <= swapSize ) { 
CopyInc( swapPtr, p0, nL ); 
Copyinc( pO, p2, nR ); 
CopyInc( (Byte*)pO + nR, swapPtr, nL ); 
return; 
elee if( nl’ > ake 
if( nR <= swapSize ) | 
CopyInc( swapPtr, p2, nR ); 
CopyDec( (Byte*)pO + nR, pO, nL ); 
CopyInc( pO, swapPtr, nR ); 
return; 
endif 


This algorithm always does the job, buffer or not. 

Find the smaller block. Swap it immediately into its final 
place. Now the larger block is in two out-of-order, but contiguous 
pieces. Wait a minute, this is what we started with! The only 
differences are: now the sizes are {smaller, larger - smaller}, and 
the start addresses have to keep up with the new pieces. 

We repeat until the two pieces were the same length. In 
other words, the final swap didn’t break anybody in two. This 
can end with sizes larger than Atom-Atom. It depends on 
whether the smaller evenly divides the larger. 





In Situ 
done = false; 


do { 


1F(nbi<¢ nk) -{ 

ne ok nL 

pR = (Atom*) ((Byte*)pR + nR); 
pais 


Lf€ nk > BRO 
(Atom*) ((Byte*)pL + nR); 


o) 
4 
n 
© 

tthe 


Swap; 


} while( !done ); 
} 
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By Richard Clark, General Magic 


eWerPe 


POWERPC FUNCTION CALLS 





It helps to know all that stuff that compilers take for granted. 


Most RISC processors, including the PowerPC, use a different 
method for calling procedures than CISC processors do. Most 
CISC processors make use of the stack for passing parameters, 
holding temporary variables, and storing return addresses. The 
PowerPC run-time architecture performs these functions 
differently. Unlike the 68K Macintosh run-time model, where 
multiple calling conventions are used, the PowerPC runtime 
model specifies one calling convention for all code, regardless 
of the programming language used. This impacts assembly- 
language programming and debugging, and a very small 
number of high-level language programs which use assembly 
language to construct a stack frame before calling a function. 

This month, we'll describe how a Power Macintosh program 
calls PowerPC functions, and give some hints for locating 
procedure calls in compiled code. We'll also go into the mail bag 
and follow up on calling between 68K and PowerPC code. 


HOW POWERPC CALLS PROCEDURES 


Most RISC processors are designed to make extensive use 
of their registers, since it takes less time for a processor to 
access an internal register than 
it does to access external 


memory. One example of this General-Purpose 


Purpose Registers are shown as 32 bits wide here, but will be 
64 bits wide on 64-bit implementations of the PowerPC.) 

In the simplest sort of procedure, which accepts only a 
small number of parameters and which doesn’t call any other 
procedures (known as a “leaf procedure”), the procedure call 
doesn’t ever touch memory: 


/* A trivial “leaf routine” */ 
int average (int a, int b) 


return (a + b) / 2; 


; The compiled version of the above routine 

; Register usage: 

; Register 3 =a 

; Register 4 = b 

; Register 5 = unused parameter register, used as scratch 
; Register 3 is used for the function result 


’ 


; The return address is in a special “link register”, not on the stack 


csect -average(PR} _ ; Start of the function 
addc r5,f3,r4 ; RS =a + b (and check for carry) 
srawi (552554 ; Shift R5 right 1 place 
addze epee) ; Copy R5 to R3 and add the carry 


; (addze = “add to zero extended) 


Floating-Point Registers 


Registers 
is the PowerPC’s load/store g 
]- System scratch 
architecture (see Powering Up, 1 TOC poincr 
February, 1994) which requires 
Parameter Parameter 
that all of the operands of an passing passing 
: : . registers ist 
instruction be loaded into eta 
registers before the operation a 
is performed. 
The Power Macintosh 
; ‘ ; “Non- 
calling conventions are biased Saiee “Non- 
‘ ; latile”’ 
heavily towards the use of aa eee 
‘ { variables) (local 
registers. (See Figure 1) Both nes 


the Fixed-point and floating- 
point registers are divided into 
“reserved” registers, parameter 
passing registers, and “local 
variable” registers. (The General 





~<@— 32 bits > 
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Figure 1— The PowerPC registers 
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4D Universal-the technology and the strategy behind these new prod- 
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Whether you are a new or experienced user of ACI products, this annual 
event is one you and members of your organization cannot afford to 
miss. Session topics are varied and comprehensive, covering program- 
ming, connectivity, user profiles, 4D Development Tools, 4D Modules, 
Object Master, developer marketing and more. Based on comments 
from you, this year we have increased the number of technical training 
sessions and customer feedback sessions. And, we have added a devel- 
oper competition on the second day so you can test your skills against 
other colleagues and of course compete for lots of valuable prizes. 


Conference attendee are eligible to attend the ACI Show exhibition. 
ACI, 4th Dimension developers and other major vendors will show a 
full suite of products and services. 


The conference is a way to get direct, first hand information on any 
topic. The variety of customer sessions and technical tracks as well as 
the ability to meet with colleagues, developers, and industry member 
can expand your knowledge, awaken new ideas, and excite your imag}- 
nation. 


Mark your calendar for July 12-14, 1994 at the Fairmont Hotel in San 
Jose, California. Register by calling (800) 767-2336 (US and Canada) 
International Registration call (508) 474-9258. 
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blr ‘ return 


In this example, both of the parameters were passed in 
parameter registers, the intermediate value was placed in an 
unused parameter register, and the return result went back in the 
first parameter register. Since the PowerPC uses an internal register 
for return addresses, nothing had 
to be placed on the stack. 

However, most procedures 
aren't nearly this simple: they use 
local variables, or call other 
procedures, have long parameter 
lists, or need to support variable 
parameter lists. If a procedure has 
any of these attributes, it needs to create and use a stack frame. 


POWERPC STACK FRAMES 


The PowerPC stack format is shown in Figure 2 . The 
PowerPC uses a “grow down” stack, just as the 68K does. 
However, that’s where the similarity ends. Each procedure is 
responsible for creating its own stack frame (unlike the 68K 
where, one could argue that the caller creates the “parameter” 
part of a stack frame and the callee creates the rest.) Once 
created, each PowerPC stack frame remains the same size — a 
procedure cannot “push” a few bytes onto the stack for 
temporary storage Finally, each stack frame must end with a 
pointer back to the previous stack frame. 

[The diagrams here are “upside-down” from what you 
normally might see in Macintosh documentation, but are in line 
with much of the documentation you're likely to come across. 
It’s a long and sordid story, and has something to do with Apple 
making a deal with a certain three-letter company, but we'll save 
that for another time. When you see these diagrams, it never 
hurts to double-check where the top of memory is. In this case, up 
is towards zero, and that’s the direction the stack grows. — Ed stb] 


Stack 


Local variables 


Parameter area 


Saved registers 
(floating-point and 
fixed-point) 





oS — 32 bits—w _top of 
memory 


Figure 2— A single stack frame 
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66 if you learn to recognize [this stuff], 
reading disassembled code 
becomes much easier. ?” 








Each stack frame may begin with a register save area. If a 
procedure intends to use one of the “non-volatile” registers shown 
in Figure 1, it must save the old value of the register and restore it 
later. These registers are saved at the “bottom” of the stack frame. 
(Only the non-volatile registers should be saved at the bottom of 
the stack — see “borrowing the 
stack” below for an explanation.) 

Next comes an unstructured 
local variable area. The current 
procedure is free to put anything 
it wants here, including any local 
variables that won’t be placed in 
the non-volatile registers. 

The parameter area comes next. This area is used to pass 
parameters to any procedures the current procedure calls, not to 
hold its own parameters. (A procedure looks into the parameter 
registers and its caller’s stack frame for parameters — the reason 
why is given in “borrowing the stack.”) As a result, the compiler 
looks at all of this procedure’s callees, and uses the size of the 
largest parameter list it finds. This area is formatted according to 
the rules given in “passing parameters” below. 

















Stack 
Pointer filled in 
Previous SP by current 
- function 
Saved Condition 
Register filled in 
Saved Link by callee 
Register 
filled in 
Saved TOC pointer | by current 
SP + 24 - function 
—<—@— 32 bits—p- top of 


memory 
Figure 3 — The Linkage Area 


The linkage area forms the end of every stack frame, and is 
a special data structure used to hold a link to the previous 
address, the return address, and the two non-volatile registers 
within the branch unit. (See Powering Up, February 1994 for a 
description of the branch unit.) The current procedure always 
fills in the “previous stack frame” field, and will fill in the “old 
return address” field if it calls another procedure. The other 
fields are either filled in by the callee, or are reserved for 
system use. This unusual “I'll fill in some fields and you fill in 
the rest” behavior is explained in “borrowing the stack.” 
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PASSING PARAMETERS 


When one procedure calls another, the caller is responsible 
for providing the parameter area on the stack, and places some 
parameters into registers and others onto the stack. The 
parameters are laid out in memory (and the registers) according 
to a simple set of rules: 

1. Each parameter begins on a 4-byte boundary. So, a C “short” 
or “char” is padded out to a 32-bit word, while pointers, 
integers, and long integers remain unchanged. The compiler 
only does this to individual parameters — it doesn’t go into 
data structures and add padding when passing them from 
procedure to procedure. 

2. The first eight words of parameters (reading the parameter 
list from left to right) are assigned to Registers 3 through 10 
(in the Fixed Point unit). If any of these parameters are 
floating-point numbers, space is set aside in one or more 
fixed-point registers, though the value might not actually be 
filled in. (See the next rule for an explanation.) 

For example, try the function: 


void Sample (short aShort, 

long aLong, 

int anInt, 

float lifesaver, 
double seeing, 
short changed, 
long shot, 

long overflow) ; 


Showing these parameters as a structure, with each of the 
parameters padded out to a word (that’s a full machine word, 
32 bits on the 601), the comments show which register gets 
which parameter: 


struct SampleParams { 


int aShort; //R3 
long aLong; // R4 
int anInt; //R5 


float lifesaver; //FPR1, and possibly R6 (see “3” below) 
double seeing; // FPR2, and possibly R7/R8 

int changed; //R9 

long shot; // R10 

long overflow; // Out of registers — this goes on the stack! 





ee Most of this information won't affect 
a C or Pascal programmer, 


until it comes time to debug. 9 





3. The first 13 Floating-Point parameters go into floating-point 
registers. Floating-point parameters always go into floating-point 
registers when the caller passes a floating-point value, as in: 


void test (short numfloats, float a, float b); 


oo cok ie ation Tee OORRMR BRE 5 


JUNE 1994 


DEVELOPER 


UNIVERSITY 


For more information, contact the Apple Developer University Registrar 
by telephone at (408) 974-4897 or fax (408) 974-0544. 


Developer University, Apple Computer, Inc. 1 Infinite Loop, MS 305-1TU, Cupertino, CA 95014 





The two floating-point values wind up in Floating-Point 
Registers 1 and 2. However, if the compiler doesn’t see a 
function prototype which gives the parameters for test (), it 
has to assume that the caller might not look in the floating-point 
registers, and so places a copy of each value in the 
corresponding Fixed-Point registers. (This explains why the 
example above showed FPR1 as the register used, but also 
mentioned R6 — the register usage has to be consistent, even if 
the fixed-point registers won't be filled in by the caller.) 


void test (); // prototype doesn’t show parameters 


test(3 20)-3.1,- 3.42) 
void test (short numValues, long a, long b) 
// this code expects numValues inR3, ain R4, and b in RS... 


A similar situation occurs when using variable argument 
lists. In that case, two things happen differently from a “normal” 
procedure call: 

1. Any floating-point values in the first 8 words are passed in 
general purpose registers, just as in the “no prototype” 
case above. 

2. Registers 3 through 10 are written out to the parameter area at 
the start of the call, and the parameters are then read from 
memory. (Since procedures with variable parameter lists often 
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loop over all of the parameters in the list, this makes the code 
much simpler.) This requires that the caller set aside a 
minimum of 8 words in the parameters area, since the 
procedure will blindly “dump” all 8 parameter passing registers. 
There’s one more element of a stack frame that isn’t shown 
here, and that’s how the end of the frame is aligned. By 
convention, the end of a stack frame should be on a 64-byte 
boundary, with extra space included in the “local variables” area 
to force this outcome. 


A STACK FRAME EXAMPLE 


If our “average” procedure calls another procedure (say, for 
integer division), a stack frame is used to hold the previous 
return address : 


extern int div (int value, int divisor); 
int average (int a, int b) 


return div(a + b, 2); 
} 


; —— resulting assembly — 


csect .average{PR} 

;--- The prolog 

mflr r0_ ; Move the return address from its “link register” into register 0 
stw r0,0x0008(SP)_ ; Save the link register into caller’s linkage area. 
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stwu SP,-0x0038(SP) ; Create a stack frame 

;--- The body 

addc Coors 4 Sho =a 

sicg. ti? ; Move 2 into R4 doad immediate) 
bl .div ; Call “div’, R3 = atb, R4 = 2 
nop ; (explained later) 

;--- The epilog 

lwz r0,0x0040 (SP); copy the saved link register to RO 
addic BESO; 00 ; Remove the stack frame 

ntl r0 ; Move RO to the link register 

blr ; return (branch to link register) 


If you examine many PowerPC functions, you'll notice 
some similarities with this one. Most functions begin with a 
standard “prolog” which saves link register and creates a stack 
frame (the first three instructions above) and (optionally) saves 
any non-volatile registers used. Most functions end with an 
“epilog” which restores the saved registers, restores the link 
register, removes the stack frame, and returns. If you learn to 
recognize these sections, reading disassembled code becomes 
much easier. 


“BORROWING” THE STACK 


There’s one interesting exception to the calling convention 
above which occurs in a “leaf procedure.” Leaf procedure don’t 
call any other procedures, so they are at the ends of the “calling 
tree.” If a leaf procedure doesn’t place any local variables on 
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the stack, it can operate without setting up a stack frame: it gets 
its parameters from registers and its caller’s stack frame, and can 
save the condition register inside its caller’s linkage area. (This 
explains why the caller sets up the parameter area and why part 
of the linkage area is used by the callee.) 

You might think that this rule is unduly restrictive, since a 
procedure can’t do much without local variables. Leaf 
procedures are permitted to use the non-volatile registers for 
local variables, just as any other procedure can, as long as they 
save the registers to the stack at the beginning of the procedure 
and restore them at the end. 

“But I thought you said the procedure doesn’t have a stack 
frame!” That’s true. In this one case, the leaf procedure is allowed 
to write information past the end of the stack frame. Normally, 
the next procedure called would overwrite such information, but 
this is a leaf procedure, and won't call anything else. 

Now, some of you might sense a trap — what happens if an 
interrupt occurs during a procedure call? Won't the interrupt 
service routine set up a stack frame and overwrite the saved 
registers? The runtime model requires that interrupts decrement 
the stack pointer by 224 bytes (which is the total size of the 
non-volatile registers rounded up to a 64-byte boundary.) 

Since leaf routines are called frequently, it makes sense to 
speed them up in this way, even if it makes the calling 
conventions a little harder to understand at first. 


RECOGNIZING CALLS IN POWERPC CODE 


Most of this information won’t affect a C or Pascal 
programmer, until it comes time to debug. Then, if you can’t 
use the source level debugging, you might want to find function 
calls at the assembly level. 

We'll begin with our simplest example, the “average” leaf 
procedure shown at the beginning of the article. When we call 
this function from main: 


main() 
{ 
int a; 
a = average(3, 4); 


} 


the resulting code looks like this: 


;--- prolog 
mflr r0 - Move the return address from the 

- “link register” into register 0 
stw r0,0x0008(SP)_ ; Save the link register 
stwu SP, -0x0040(SP) ; Create the stack frame 
:--- body 
li r3,3 -R3 = 3 (first parameter) 
li r4,4 - R4 = 4 (second parameter) 
bl S-0x0024 : call “average” 
stw r3,0x0038(SP) ; Copy the result to “a” 
,--- epilog 
lwz r0,0x0048(SP) ; Get the saved link register 
addi SP,SP,64 - Remove the stack frame 
mtlr r0 - Restore the link register 
blr - Return (branch to link register) 
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New in Draginstall 1.5.3 


¢ New compression algorithm 
saves 15-20% more space than 
previous versions. 







_ ¢ International templates allow 
building of French, German, 
and Italian installers. 









_@ New external allows creation 
of aliases for installed files. 


eo 2? Ix 


A more common variation occurs when “main” and “average” 


are in different files. In that case, you'll see either: 
bl .average{PR} _ ; call “average” 


nop 
Or 
bl .average {GL} ; call “average” via glue code 
lwz 20(SP) ,R2 


The first case indicates that “main” and “average” were 
linked together into the same code fragment; the second case 
indicates a call between code fragments (usually into a shared 
library.) The second case is also known as a “Cross-TOC?” call. 

As we explained in the April Powering Up, each code 
fragment consists of both a code section and a data section. The 
TOC (Table of Contents) is a block of pointers in the data section 
which points to individual global variables and “Transition 
Vectors” used to call between code fragments. Register 2 should 
always point to the beginning of the current function’s TOC, so if 
one function calls another in a different module, the caller must 
set up register 2 before transferring control. 

This setup code is inserted automatically by the linker. 
When the linker detects a call between code fragments, it 
appends some “glue” code to the fragment under construction, 
changes the “branch and link” instruction to point to this glue 
(hence the change from “.average{PR}’ to “.average{GL}”), and 
replaces the no-op (nop) instruction with a “restore register 2” 
instruction. 

Typical glue code looks something like this: 


csect .average({GL} 
.average 
lwz r12,average(RTOC) ; Get average’s Transition Vector address 
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stw RTOC,0x0014(SP) — ; Write the old value of R220 bytes below 

;the top of the current function’s stack frame 

; (this is in the linkage area) 

; Get the final code address 

; from the Transition Vector 

lwz RTOC,0x0004(r12) ; Get new value of R2 from Transition Vector 
; (this is the proper value for the callee) 

mtctr r0Q__ ; Stick the code address into the “count register” 

betr ; Jump through the count register 


lwz r0,0x0000(r12) 


Since the glue code uses a “jump to” instruction to get to 
the destination (a “goto” for you old BASIC fans), the callee will 
return back into the original caller’s code, and not into the glue 
code. Therefore, the caller must contain the “reload R2” 
instruction which puts the TOC pointer back where it belongs 
before continuing. 

Now we come to the real question: “how do I recognize a 
function call in PowerPC code?” The answer is deceptively 
simple: look for the “branch and link” (b1) instruction, and 
work your way backwards, looking for loads into Registers 3 
through 10 (and Floating-Point registers 1 through 13.) Most 
developers find that this trick is much easier than reading 
forward through a long listing trying to track each value in and 
out of the registers. 


JUST WHEN YOU THOUGHT YOU UNDERSTOOD... 


There’s one more thing that you must know about when 
reading decompiled code — when you compile a file for 
symbolic debugging, the compiler inserts some extra code 
which copies all of the parameters into the caller’s parameter 
area on the stack, and only moves them into registers when 
needed. (If a parameter is changed, the changed version is 
written back to the stack.) This trick simplifies debugging, as 
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the debugger only has to look on the stack for local variables 
and parameters, but it complicates the code. So, if you see “stw 
R3, 56(SP)” in a function’s prolog, you’re probably looking 
at code that was compiled with symbols on. 


FROM THE MAIL BAG 


After looking at the April issue (with the articles on the 
Code Fragment Manager and calling 68K code from PowerPC 
code), some developers have asked “how do I call PowerPC 
code from 68K code?” 

If you want to leave the 68K code alone, you need to 
construct one or more Routine Descriptors in the PowerPC code 
and pass the addresses of these (Universal Procedure Pointers, 
in other words) to the 68K code. Then, the 68K code can 
simply jump through the universal pointer. 

The PowerPC code can provide a function whose job it is 
to construct these pointers (as shown in the April article), or if 
the code is in a resource, can use the definitions in “Mixed 
Mode.r” to place a Routine Descriptor in front of the code. 

If you want to leave the PowerPC code alone, the 68K code 
can use a Mixed Mode A-Trap to create the routine descriptor. 
The bad news is this: blindly calling “NewRoutineDescriptor” 
won't do what you want. (When compiling for the 68K, 
NewRoutineDescriptor is an “null” macro that just returns the 
supplied procedure pointer.) The solution is to copy the 
definition of NewRoutineDescriptor, and convert the contents of 
the “THREEWORDINLINE’” macro into an actual inline. 

The result of all this work looks like this: 


#if USES68KINLINES 
pascal UniversalProcPtr InlineNewRoutineDescriptor ( 
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ProcPtr theProc, 
ProcInfoType theProcInfo, 
ISAType theISA) 
= {0x303C, 0x0000, 0xAA59}; 
fendif 


typedef void (*OurProcPtr) (short); 


void CallPowerProc (ProcPtr powerCodeAddress, 
short onlyParameter) 
{ 
OurProcPtr ourUPP; 
short procInfo = kCStackBased | 
STACK _ROUTINE_PARAMETER (1, kTwoByteCode)) ; 


tif USES68KINLINES 
ourUPP=(OurProcPtr) InlineNewRoutineDescriptor ( 
powerCodeAddress, 
procinfo, 
kPowerPCISA) ; 
ffelse 
// We’re compiling for PowerPC - see the comments below 
ourUPP= (OurProcPtr) NewRoutineDescriptor ( 
powerCodeAddress, 
procInfo, 
kPowerPCISA) ; 
#tendif 
CallUniversalProc((UniversalProcPtr)ourUPP, procInfo, 
onlyParameter) ; 
// If you *know* this is 68K code, you could just use: ourUPP(onlyParameter) 
// but using CallUniversalProc covers the possibility that this could be compiled 
// for PowerPC some day without changing the sources 
} 


That’s all for now. Look in next month’s Powering Up 
column for more of the latest tips for writing, debugging, and 
tuning PowerPC code. 
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By Steve Kiene, Software Ilusionist, MindVision Software 





MACINTOSH DRAG AND DROP 





You've wanted it for years, they finally delivered it, but they hardly told anyone! 


ABOUT THE AUTHOR 
Steve has chosen the title “Software Illusionist” 
because he feels in most of things that he has been 
writing lately there is very little correlation between what 
the code actually does and what the user thinks is 
happening. Steve says, “Programming is an art; the user 
doesn’t care what your code is doing. All they want is a 


specific result, whether it’s having more disk space, a 
faster machine, or whatever. The implementation is 
irrelevant. The result is what is relevant. Look at the 
680x0 emulator in the Power Macintosh. It’s the ultimate 
illusion. It convinces not only the user, but the software 
as well, even software like TMON Pro or Macsbug which 
think they know a 680x0 when they see one.” 





In September of last year Apple released an important new 
technology called Macintosh Drag and Drop. With all the 
fanfare over OpenDoc, AOCE, PowerPC, and other new 
technologies, most people haven’t had a chance to see 
Macintosh Drag and Drop in action. I don’t generally get 
excited about new technologies, but I think Macintosh Drag and 
Drop is totally cool. I remember talking to some friends at 
Apple a couple of years ago about doing something like 
Macintosh Drag and Drop. I’m glad somebody at Apple had the 
initiative to write this because once you've used it, you'll 
wonder how you lived without it. 


WHAT IS MACINTOSH DRAG AND DROP? 


A key concept of the Macintosh interface is direct 
manipulation. For example, in the Finder you can drag a 
document icon and drop in into an application icon, which 
results in the document being opened with the application. 
Macintosh Drag and Drop is an extension to the Macintosh User 
Interface that allows direct manipulation of data between 
different windows and applications as easy as dragging icons in 
the Finder. A user simply selects the data they want to drag and 
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then drag it to the desired location. Macintosh Drag and Drop is 
an intuitive alternative to cut and paste, but it is much more than 
that. Macintosh Drag and Drop implements the Drag Manager in 
the OS, and both terms are used by people interchangeably. The 
Drag Manager integrates with the Translation Manager to provide 
transparent translation of data types. If you want to provide data 
in a specific format, you can ask the Translation Manager to 
perform the translation for you. You can also find out whether 
the user dropped the selection on the Trash, so you can delete 
whatever it was they were dragging. 

There are existing applications which followed the Findet’s 
direct-manipulation lead while blazing new trails for third-party 
applications, and implemented Drag Manager-like features 
within their context. Microsoft Word allows you to drag selected 
text within the same document window. QuarkXPress allows 
you to drag objects between other XPress document windows. 
Other examples abound. Recently I added Drag and Drop (the 
real thing from Apple) support to our installer product 
Developer Vise. 





66 once you’ve used it, 
you'll wonder how you lived 
without it.?? 





The three screen shots below show a drag in action. The 
first shows an item being selected from an archive’s Finder-style 
list view. The second shows the outline of the item being 
dragged. The third screen shot shows the result of dropping the 
item on the desktop — the file was extracted from the archive 
and saved as a disk file. It was positioned on the desktop in the 
place the user dropped the item. This is a really cool way to get 
items out of an archive file. To add files to the archive you 
simply grab them in the Finder and drag them to an archive 
window. Macintosh Drag and Drop lets you do all this, and is 
much easier than using the Standard File dialogs to add files to 
the archive. [Death to StandardFile! — Ed stb] 
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Original Compressed Percent Date 
Size Size Smaller Modified 













Order Name Kind 

vv (© Eudora folder 1,008,271 454 ,382 ee 
CiscoNavs rsre/CSOm 409 262 36% 2/20/94 

b> (2 Dialup Folder folder 138,104 58,506 58% 2/20/9 a 
+) Eudora Q&A STAK / WILD 114,688 41,890 64% 2/20/9 
EudoraT ables rsrc/CSOm 3,794 1,372 64% 2/20/9 








Fi] EudoraT ables Helper rsre/CSOm 1,459 546 63% 2/20/9 
APPL/CSOm 473,498 217,746 55% 12/1/79 


> (9 Extras Folder folder 112,550 10,248 


Netcom UNIX Nays rsre/CSOm 417 196 
17 file(s), 4 folder(s) in archive 1,008,271 454 382 

















Step 1: Selecting something to drag 


: Eudora. vet = 


Original Compressed Percent Date 
Pe a S.-i  R LL Name Kind Size Size Smaller Modified 


VY © Eudora folder 1,008,271 454 La ””S*:*tcMaer «100827 aga de? (SSR 2a e 
CiscoNays rsre/CSOm 409 262 
> (© Dialup Folder folder 138,104 58,506 
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EudoraTables rsre/CSOm 3,794 1,372 
EudoraTables Helper rsro/CSOm 1,459 546 2/20/94 
APPL/CSOm 473,498 ~—-217,746 12/1/93 
(0 Extras Folder _ folder 112,550 10,248 2/20/94 | 


FR Netcom UNIXNavs “RE  rsre/CSOm 417 196 
1,008,271 454,382 55% 





2C] Eudora.uct 
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Original Compressed Percent Date 
Order Name Kind Size Size Smaller Modified 


vv © Eudora folder 1,008 271 454 382 
CiscoNavs rsre/CSOm 409 262 
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(0 Extras Folder folder 112,550 10,248 


Netcom UNIX Nays rsre/CSOm 417 196 
17 file(s), 4 folder(s) in archive 1,008,271 454 382 
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Step 3: Dropping the file on the desktop 


With any new, totally cool technology there are always 
new, totally cool terms to learn. 


Macintosh Drag and Drop 


The System Extension that implements the Drag Manager. It 
is also the terminology used for the feature when indicating that 
a product can support the Drag Manager (as in “Developer VISE 
supports Macintosh Drag and Drop”). 


Drag Manager 
A part of the Macintosh Toolbox, like the Control Manager, 
Menu Manager, or Window Manager. 
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Clipping file 


A clipping file is a file created in the Finder that contains 
whatever data was dragged to the Finder. For example, if you 
select some text in a Drag Manager savvy text editor, you can 
drag the text to the Finder and it will create a clipping file. You 
can open this clipping file in the Finder and view the contents. 
You can also drag a clipping file to a Drag Manager savvy 
application and it will accept the data as if it was dragged from 
the original application that produced the clipping file. Clipping 
files are like storage bins for drag objects. 


Flavor 
A flavor is a specific data format such as PICT, TEXT, snd, 
etc. 


Clipping Extension 
A System Extension that allows the Finder to support 
clipping files. 


Dragging Enabler 

A System Extension that allows System 7.1 to support 
Macintosh Drag and Drop. It is not needed when running 
System 7 Pro. 


WHERE TO FIND MORE ON MACINTOSH DRAG AND DROP 


The Macintosh Drag and Drop Developer's Kit is available 
from APDA for the rob-you-blind price of $75.00. There is an 
excellent article written by the authors of the Drag Manager in 
Develop Issue 16. Online documentation for the Drag Manager 
is on the February 1994 Developer CD. 


DETERMINING IF THE DRAG MANAGER IS PRESENT 


You can determine if the Drag Manager is present by 
calling the Gestalt function with the selector gestaltDragMgrAttr. 


#define gestaltDragMgrAttr 'drag' 


The Gestalt function will set or clear the following bit 
depending on whether the Drag Manager is present: 


define gestaltDragManagerPresent 0 


DRAG ITEM FLAVORS 


Most items that can be dragged, such as text, graphics, and 
sound, can be represented using several different data formats. 
For applications to communicate what type of data is being 
dragged, the Drag Manager introduces the concept of drag item 
flavors. Flavors allow a dragable item to be represented in one 
or more forms in order for other applications to be able to 
interpret the item. For example, a text selection of “MacTech 
Magazine” can be represented simply as “TEXT”. In addition, 
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other “flavors” can be provided to richen the data. A ‘styl’ flavor 
may be provided to give text style information. Another 
common flavor is rich text format, or RTF. The RTF includes 
much more information about the fonts, styles, page size, 
margins, etc. The application that initiated the drag might be a 
high-end word processor that 
Supports very rich style 
information in it’s own 
proprietary format, in which 
case it could add another 
flavor to allow data transfer in 





it’s internal format. Because 
there is no way to know 
where the drag selection will be dropped, it is advisable to 
provide all possible flavors so that the receiver can decide 
which format they would like. It’s kind of like going to a place 
with thirty-some-odd flavors; they make sure there are plenty of 
flavors to choose from so you can pick the one that you want. 


DRAG HANDLERS 


In order for the Drag Manager to know your application 
can receive dragged items, you must register with the Drag 
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66 With any new, totally cool technology, 
there are always new, totally cool 
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Manager by installing drag handlers for any windows which can 
receive data. There are two types of drag handlers that you 
install: 


¢ A drag tracking handler that the Drag Manager calls when 
the user drags a selection through the content region of one 
of your windows. This allows you to track the drag and 
indicate whether you can accept the drag or not. 

e A drag receive handler that the Drag Manager calls when 
the user finishes a drag in one of your windows. This allows 
you to receive the data the user was dragging. 


The Drag Manager conveniently provides routines to allow 
you to register handlers for your windows. You can install 
different handlers for different windows, multiple handlers for a 
single window, or no handlers at all. The choice is yours. 


DRAG TRACKING 


When the user drags a selection into one of your windows 
which has installed a tracking handler you will receive 
messages from the Drag Manager. These messages allow you to 
track the drag as it passes through your window. As the drag is 
taking place, you can use several Drag Manager routines to 
determine the characteristics of what is being dragged and 
decide whether or not you can accept the data. The messages 
are as follows: 


e An enter handler message arrives when a drag enters a 
window that is handled by your tracking handler when the 
drag has come from a window that is not handled by the 
same tracking handler. This allows you to perform any setup 
required for that particular handler to operate. 

e An enter window message arrives when a drag enters a 

window that is handled by 

your tracking handler. It is 
important to understand the 
difference between this 
message and the enter handler 
message. An enter handler 
message is delivered when the 

focus of a drag enters a 
window which has a different tracking handler than the 
window that the drag just left. An enter window message is 
received regardless of which handler the previous window 
had installed. 

e An in window message arrives as the user drags within a 
window handled by your tracking handler. This is where 
you give visual feedback to the user indicating whether this 
window can accept the drag. The feedback is generally in 
the form of drawing a blue outline around the content 
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region of the window. It gets called a lot, and doesn’t wait 
for the mouse to move. 

e A leave window message when the drag leaves a window 
handled by your tracking handler. 

e A leave handler message when the drag enters a window 
that is not-handled by the current tracking handler. 


RECEIVING DATA 


When the user drops a collection of data on a window that 
has a drag receive handler installed, the Drag Manager calls any 
receive handlers so they can receive the data the user dropped. 
The Drag Manager provides several functions for inspecting the 
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data as well as actually receiving the data. 


USING THE DRAG MANAGER 


The code snippets shown here come from Developer VISE 
3.0, an installer builder that MindVision sells. Developer VISE 
includes functions like an archiver in that it can create an 
archive in which files are stored. The user interface for this is a 
window with a file list showing the files in the archive. This 
type of product is a natural place to implement Macintosh Drag 
and Drop, so I’ve taken pieces of code directly from our source 
to show how easy it is to add Drag Manager support to your 
existing application. I have, however, removed some parts 
(mostly error checking) for clarity, but you should always check 
error results, and the Drag Manager is no exception. 


INSTALLING DRAG HANDLERS 


You can register a drag handler with the Drag Manager by 
calling InstallTrackingHandler and InstallReceiveHandler. Both 
functions take a pointer to the window that you are installing 
the handler for. If you want the handler to be the default 
handler for all your windows, pass nil. These handlers are 
called default handlers. You can specify a reference constant 
when installing a handler. This can be used to provide 
additional information to your handler, such as a pointer to a 
data structure used by your handler. Because you cannot be 
assured that the Drag Manager is installed, you must always 
check before calling a Drag Manager function. Add this code 
after you create a window in which dragging is allowed. 


if (gHasDragManager) { 
err = InstallTrackingHandler (MyTrackingHandler, 
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theWindow, (void *)dataPtr) ; 
err = InstallReceiveHandler (MyReceiveDropHandler, 
theWindow, (void *)dataPtr) ; 


MyTrackingHandler is a pointer (that’s a UniversalProcPtr 
for you PowerPC types) to your tracking handler. 
MyReceiveDropHandler is a pointer to your receive handler. As 
always with callback routines, make sure they are in locked 
segment. If the code block moves, the Drag Manager will not 
know this and will blindly call where it thinks your code is 
anyway, and that’s generally a bad idea. 


REMOVING DRAG HANDLERS 


To remove a drag handler from the Drag Manager's 
registry, call the corresponding remove handler functions: 


if (gHasDragManager) { 
RemoveTrackingHandler (MyTrackingHandler, theWindow) ; 
RemoveReceiveHandler (MyReceiveDropHandler, theWindow) ; 


MyTrackingHandler is a pointer to the tracking handler that 
you installed for the specified window. MyReceiveHandler is a 
pointer to the receive handler that you installed for the specified 
window. If you pass nil as the window pointer, the Drag 
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Manager will remove the specified drop handler as the default 
handler. Call this code before closing the specified window. 


PERFORMING A DRAG 


For brevity, I will assume your program can already 
perform dragging of objects within a window. To support 
dragging of objects outside your window you need to fork your 
code when the user starts to drag an object. 


if (gHasDragManager) { 
tLong = DragItem(theWindow) ; 
} 
else { 
tLong = DragGrayRgn(gRgen, origClick, &limitRect, 
&slopRect, 0, 
(DragGrayRgnProcPtr) &FileDragHook) ; 


DragItem is our own procedure which does the necessary 
work to perform a drag using the Drag Manager. Here it is 
quickly, and we'll go over some of the details in a moment. 


long DragItem(WindowPtr theWindow) 
{ 


ArcFileType theFile; //program-specific structure 
DragReference theDrag; 

RgnHandle tempRen; 

Point TEE; 

short result; 

PromiseHFSFlavor hfsFlavor; 

OSErr err; 


theFile = GetSelectedFile(theWindow) ; 


//set up to do the drag 
err = NewDrag(&theDrag) ; 


hfsFlavor.fileType = theFile.af_FInfo.fdType; 
hfsFlavor.fileCreator = theFile.af_FInfo.fdCreator; 
hfsFlavor.fdFlags = theFile.af_FInfo.fdFlags; 
hfsFlavor.promisedFlavor = 'VCTI1'; 
AddDragItemFlavor(theDrag, 1, flavorTypePromiseHFS, 
&hfsFlavor, sizeof(hfsFlavor), flavorNotSaved) ; 


AddDragItemFlavor(theDrag, 1, 'VCT1', nil, 0, 0); 


AddDragItemFlavor(theDrag, 1, kDragItem, nil, 0, 
flavorSenderOnly) ; 


SetDragSendProc(theDrag, MySendDataProc, (void *)theWindow): 


SetPetatrt, 0.-0) : 
LocalToGlobal (&tPt);: 
OffsetRgen(gRgn, tPt.h, tPt.v); 


SetDragItemBounds(theDrag, 1, &(**gRgn).rgnBBox) ; 


tempRgn = NewRgn(); 
CopyRgn(gRgn,tempRgn) ; 
InsetRgn(tempRgn,1,1); 
DiffRgn(gRen,tempRegn, gRen) ; 
DisposeRgn(tempRgn) ; 


// do the drag 
result = TrackDrag(theDrag, &gEvent, gRen); 


//clean up and return the result 
DisposeDrag(theDrag) ; 


if (result) { 

return (0x80008000) ; 
} 
else { 

return (0): 
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The GetSelectedFile routine is our own routine to 
determine what is selected. We call NewDrag to allow the Drag 
Manager to create a new instance of a drag. The next step is to 
add flavors to the drag. This is done by calling 
AddDraglItemFlavor, which is defined as: 


pascal OSErr AddDragItemFlavor (DragReference theDragRef, 
ItemReference theltemRef, 
FlavorType theType, 
void *dataPtr, 
Size dataSize, 
FlavorFlags theFlags); 


The Drag Mgr creates a new drag item if the specified item 
reference is different from all other item reference numbers, 
otherwise it uses the existing instance. To add multiple flavors 
to the same drag item, specify the same item reference. Think 
of an item reference as a ref num for a file. It is used to 
uniquely identify the particular drag item. FlavorType is the 
type of flavor we are providing. The Drag Manager defines the 
following special flavor types: 


#tdefine flavorTypeHFS 'hfs ' // flavor type for HFS data 
define flavorTypePromiseHFS 'phfs' // flavor type for promised HFS data 
define flavorTypeDirectory ' diry' // flavor type for AOCE directories 


In this case we are creating a flavorlypePromiseHFS, 
which means we will deliver a file system object (in our case it 
will be a disk file), but only if the receiver requests that we do 
so. We promise the file (rather than deliver it directly) because 
we must decompress the file from our archive to deliver it, and 
it makes no sense to spend the time decompressing if the drag 
is not successful. If the drag is successful and the receiver 
decides that they want our file, they ask us to deliver the file at 
that time. 

The next parameter is a pointer to the flavor data to add. 
Because we are using a predefined flavor, we have a 
corresponding predefined data structure for that flavor: 


Struct PromiseHFSFlavor { 


OSType fileType; // file type 

OSType fileCreator; //file creator 

unsigned short fdFlags; // Finder flags 

FlavorType promisedFlavor; // promised flavor containing an FSSpec 


i 
typedef struct PromiseHFSFlavor PromiseHFSFlavor; 


The first three fields are self-explanatory. The fourth field, 
promisedFlavor, is a flavor that will contain an FSSpec to the file 
system object if the receiver requests it. This is used by the 
receiver to know what flavor to ask for in order to find out 
where to find the file system object. 

The fifth parameter in AddDragltemFlavor is the size of the 
data being provided. The last parameter, FlavorFlags, provides 
additional attribute information about the flavor. They are 
defined as: 
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enum { 
flavorSenderOnly = 0x00000001L, // flavoris available to sender only 
flavorSenderTranslated= 0x00000002L, // flavor is translated by sender 
flavorNotSaved = 0x00000004L, // flavor should not be saved 
flavorSystemTranslated= 0x00000100L =_// flavor is translated by system 


i; 


flavorSenderOnly 

Set if this flavor is only available to the sender. You might 
use this when your objects contain information proprietary to 
your specific application. Because no one else would 
understand this flavor there would be no reason to send it to 
everyone. 


flavorSenderTranslated 


Set if the sender performs a translation on the data to be 
able to offer this flavor. This is useful to a receiver if it needs to 
determine if the sender is performing its own translation to 
generate this data type. Typically, receivers that store dragged 
data without interpreting each data type do not store translated 
types. For example, if you are trying to be very flexible and 
provide the data in as many flavors as possible, you would set 
this flag for any flavors that you have to translate from a 
different format to generate. This way the receiver can decide 
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which format they want if they are looking for a specific type. 
But, if the receiver is simply storing all the flavors, there might 
be no need to store many different flavors that it may be able to 
generate itself. 


flavorNotSaved 

Set if the flavor data should not be stored by the receiver. 
This is useful for marking flavor data that will become invalid 
after the drag has completed. For example, set this flag if you 
are providing a flavor that is promised, or for a flavor that is 
simply providing information that is only useful while the drag 
is taking place. 


flavorSystemTranslated 


Set if the flavor data is provided by the Translation 
Manager. If this flag is set, the Drag Manager will obtain the 
required data types from the sender and then it will use the 
Translation Manager to provide the data type the receiver 
requested. 


In our case we use flavorNotSaved because the data has no 
use once the drag is completed. When the drag is completed 
the receiver will ask for the promised data and we will provide 
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the actual disk file at that time. 


AddDragItemFlavor(theDrag, 1, 'VCT1', nil, 0, 0); 


This will add the flavor type we specified as the promised 
flavor in the previous AddDrawltemFlavor. There is no need to 
pass any data now because the receiver will explicitly ask for 
the data once the drag has completed successfully. This is the 
flavor type that the receiver will request when it wants the file 
system object that we promised. 


AddDragItemFlavor (theDrag, 1, kDragItem, nil, 0, flavorSenderOnly) ; 


This adds our own internal representation of an item in an 
archive. It is for use only by our application, so the flags are 
flavorSenderOnly. 


SetDragSendProc(theDrag, MySendDataProc, (void *)theWindow) : 


The SetDragSendProc functions sets the drag send 
procedure for the given drag reference. A drag’s send procedure 
is called by the Drag Manager when the receiver of a drop 
requests the data of a flavor that was promised (no data was 
provided by the AddDraglItemFlavor). If you always provide the 
flavor data when calling AddDragItemFlavor, there is no need to 
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call this. In our case, we have promised the data, so we must 
install a send procedure. The last parameter is a reference 
constant that can be used to pass specific data to the send 
procedure. In our case we pass the window where the drag 
originated. The specifics of the send procedure are explained 
later. 


SetPt(&tPt, 0, 0); 
LocalToGlobal (&tPt) ; 
OffsetRgn(gRgn, tPt.h, tPt.v); 


In this snippet of code, gRgn is a region containing the 
outline of the selected item in the window. We normally use 
this region in local coordinates, however, the Drag Manager 
needs it in global coordinates so this converts the region to 
global coordinates. The illustration below shows the drag region 
for this example: 








Eudora.vuct 


Original Compressed Percent Date 
Order Name Kind Size Size Smaller Modified 


v7 (3 Eudora folder 1,008 ,271 454 382 
CiscoNavs rsre/CSOm 409 262 36% 2/20/94 

> (2 Dialup Folder folder 138,104 98,506 58% 2/20/9 
GP Eudorag&a | Sy STAK ‘WILD 114,688 41,890 64% 2/20/9 
EudoraT ables kK rsre/CSOm 3,794 1,372 64% 2/20/9 
EudoraTables Helper rsro/CSOm 1,459 546 63% 2/20/9 
Eudora 4.1 APPL/CSOm 473,498 217,746 55% 12/1/9 

> = Extras Folder folder 112,550 10,248 91% = 2/20/94 
Netcom UNIX Nays rsro/CSOm 417 196 i) 


17 file(s), 4 folder(s) in archive 1,008,271 454 382 
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Drag Region 


SetDragItemBounds(theDrag, 1, &(**gRen).rgnBBox) ; 


The SetDragItemBounds function sets the bounding 
rectangle of the given drag item. The rectangle must be 
specified in global coordinates. The illustration below shows the 
drag item bounds: 
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Original Compressed Percent Date 
Order Name Kind Size Size Smaller Modified 


(© Eudora folder 1,008,271 454 382 
CiscoNays rsre/CSOm 409 262 36% 2/20/94 
b> (4 Dialup Folder folder 138,104 58,506 58% 2/20/9 
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Drag Item Bounds 


tempRgn = NewRgn(); 
CopyRgn(gRgn, tempRgn) ; 
InsetRgn(tempRgn, 1, 1); 
DiffRgn(gRgn, tempRgn, gRegn); 
DisposeRgn(tempRgn) ; 


This code snippet builds an outline of the selected item as 
a region to pass to the Drag Manager. 
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result = TrackDrag(theDrag, &gEvent, gRgn) ; 


The TrackDrag function performs a drag operation with the 
specified drag reference. You must pass the event record that 
resulted in the mouseDown event which caused the dragging to 
be started. You must also pass a region in global coordinates 
which is the outline of the objects being dragged. In this case 
we pass our region gRen. If the drag is successful, meaning the 
user dropped the object in a window which accepted the data, 
TrackDrag will return noErr. If the drag is not successful, 
meaning the receiver did not accept the data, TrackDrag will 
return userCanceledErr. 


err = DisposeDrag(theDrag) ; 


The DisposeDrag function disposes of a drag reference and 
its associated data when a drag has been completed. 


PROVIDING FLAVOR DATA ON DEMAND 


If the receiver of a drop requests flavor data that has not 
been cached by the Drag Manager (in our example, the 
promised HFS data), the Drag Manager will call the drag’s send 
data procedure to demand the data. Below is the code for our 
send data procedure: 


pascal OSErr MySendDataProc(FlavorType theFlavor, 
void *refCon, 
ItemReference theltem, 
DragReference theDrag) 


AEDesc  dropLoc; 
FSSpec target; 

OSErr err; 
Boolean wasChanged; 


if (theFlavor== 'VCT1') { 
err = GetDropLocation(theDrag, &dropLoc) ; 


err = ResolveAlias(nil, (AliasHandle)dropLoc.dataHandle, 
&target, &wasChanged) ; 
if (err) { 
return (err); 


// Decompress item 
err = ExtractSelectedItems((ArchiveWPtr)refCon, &target) ; 
if (err) { 

return (err); 


err = SetDragItemFlavorData(theDrag, theItem, 'VCT1', 
(Ptr)&target, sizeof(target), OL); 


return (noErr); 


When the Drag Manager calls our send data procedure it 
provides us with the flavor type requested, a reference constant, 
the item reference number, and the drag reference. Recall that 
we used flavorTypePromiseHFS which requires us to promise a 
specific flavor so the receiver can request the file system object. 
In our case we promised a flavor of ‘VCT1’. The drop receiver 
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Put A Spelling Checker 
In Your Application 


Working Software offers several options for adding 
a spelling checker to your applications. Call us. 


THE FREE WAY -- Add Apple Events Word Services and our 
award-winning Spellswell 7 will work with your app as if built- 
in. Our FREE Apple Events Word Services Developer Kit in- 
cludes source code for a sample word processor. (WordPerfect, 
Eudora and Fair Witness use Word Services.) 


THE CUSTOM WAY - Build our 93,000-word OEM Spells- 
well source code (MPW, Think C or Think Pascal) right into your 
application (takes 2 days). Supplemental dictionaries also avail- 
able. Fees depend on your circumstances - call for details. 


Contact us for free object-only OEM Demo and/or 
free Word Services Software Development Kit 


Working Software, Inc. 


P.O. Box 1844 / Santa Cruz, CA 95061 
(800) 229-9675 / (408) 423-5696 / FAX (408) 423-5699 
AppleLink D1620 / CompuServe 76004,2072 





will ask us for that flavor when it wants the file system object, 
so we check to see if the requested flavor matches ‘VCT1’. If it 
does we can proceed with the rest of the function. 

The GetDropLocation function will return an AppleEvent 
descriptor describing the drop location. If the destination is the 
Finder, the Finder sets the drop location to be an alias to the 
location in the file system that received the drag. 

We call ResolveAlias to determine the location where the 
file should be placed. We then call one of our functions to 
extract the selected items from the archive and store them in the 
location specified by target. 

The SetDragltemFlavorData function allows us to fill in the 
data for a specified flavor. This is commonly done when data 
was promised and now it is time to provide the actual data. We 
promised to provide an FSSpec describing where the file system 
object was stored. Since we extracted the file to the location it 
was dropped by the user, we simply provide the FSSpec that we 
obtained in the ResolveAlias call. 


Continued on page 66 
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E* WORLD US-CENTRIC? 

In the “Newton Developer 
Conference” article (March 94) you 
mentioned Apple claims that “cost issues 
(with AppleLink) will go away when 
Apple Online Services moves away from 
the GE system to the new in-house 
Apple System (eeWorld).” That’s 
probably true, unless you live outside 
the continental U.S. Then you’ll most 
likely be hit with a $12 per hour 
surcharge, something that AppleLink 
does not have, but some other on-line 
services do have, such as America 
Online. If ee World contains such a 
surcharge, it will most likely be 
boycotted by those who do not live in 
the continental U.S., just like AOL is 
now. Let’s hope Apple makes e* World 
financially accessible to everyone. 

— Bill Modesitt, Maui Software 


[We contacted a spokesperson for 
eWorld. They were unable to provide a 
comment about Apple’s plan because this 
kind of thing is still under discussion, 
and has not been decided upon as of this 
printing — Ed stb] 





MORE INTERMEDIATE STUFF, PLEASE 


I just want to thank you for the 
February issue again. The Think C Top 
Ten was excellent! Please... more of 
that. That level of programming was 
perfect for me and I bet for a lot of 
others. With all the crazy new 
techniques which are evolving, we as 
programmers need to see the code and 
the examples. For me I felt that was 
about an intermediate level. I need 
more intermediate level stuff and so do 
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a lot of others. What you really need is 
to get some of that on getting started. :-) 
— mAtz, depaul.edu 


[Thanks for the thanks. We take feedback 
like this to heart, and we'll see what we 
can do to bring you more of what you're 
asking for— Ed stb] 





MCL FOR EVERYONE? 


You may be well-informed on this 
already, perhaps better informed than 
I am. 

The internet newsgroup 
comp.lang.lisp.mcl has, in recent weeks, 
been filled with discussion about Apple’s 
decision not to port Macintosh Common 
Lisp (MCL) to the PowerPC, and about 
Apple’s plans to sell it to a third party. 
The newsgroup, as a whole, views this 
with sadness. But what might be of 
interest to you and MacTech is that the 
newsgroup outcry made it clear that lots 
of sophisticated and innovative work is 
done with MCL. Just to drop one name: 
it’s the language of choice for one or 
more research groups at MIT’s Media Lab. 

I subscribe to your magazine, and 
often benefit from it. I use MCL for 
exploratory programming, and I — like 
many others — find it to be a superb 
tool. The binding to the Mac Toolbox is 
elegant and easy to use, accomplished 
with a set of CLOS classes. 

I suppose that someone will buy MCL 
from Apple, and do the PowerPC port, and 
that the future of MCL will be reasonably 
strong, though not as strong as if Apple 
were to continue with the product itself. 

I wish to propose that MacTech 
offer regular coverage of this fine 








programming tool. Thank you. 
— Paul Shannon, pshannon@nrao.edu 
National Radio Astronomy Observatory 
Charlottesville, Virginia 


[I agree with you that development 
environments/languages like MCL (and 
SmallTalk and Dylan) go under- 
recognized and under-utilized. I suspect 
that most Mac developers don’t know that 
a dynamic environment like it exists, and 
that development in such an environment 
is richer, rapid, and completely missing the 
compile/link/debug cycle we all know and 
love so much. If readers want to see more 
coverage of tools like MCL, we need to hear 
from you. Please let us know at 
editorial@xplain.com — Ed stb] 





MORE CHALLENGE FOR THE 
PROGRAMMERS? 


Well, your March issue’s programmer 
challenge has finally motivated me to 
write to the magazine, because I think 
the “Bitmap to Text” challenge is a 
useless, “toy problem”, and I would like 
to see these challenges producing more 
useful examples of source code. 

I also think the parameters of the 
challenge should be changed to allow 
C++, C with object extensions, as well as 
ANSI C, and to allow usage of MPW 
(Symantec and Apple) compilers as well 
as Symantec’s stand-alone compilers. Since 
ROM calls are allowed, the portability of 
code implied by ANSI C is irrelevant. 
Possibly routines written in applescript, 
hypertalk, mpw scripting language, “awk” 
(aka “gawk”) should be allowed also. And 
don’t forget Pascal and Modula-2. 

Since almost all code that I write is 
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owned by my Employer, I will not be 
able to submit code to these contests 
myself. Your provision that “all entries 
are the property of MacTech Magazine” 
would seem to imply exclusive copyright 
ownership of the submitted code. I hope 
you can change that wording to 
explicitly claim non-exclusive right to 
publish, with ownership of copyright 
retained by the submitter. 

As I stated earlier, I would like to 
see the programmer challenge show- 
casing useful code, which may be 
larger than a small set of functions. In 
particular, I desire tools for writing and 
understanding programs as well as tools 
to use im programs. 

Here is a quick list of program 
challenge ideas: [edited for brevity and 
to keep up suspense should we use any of 
these sixteen(!) suggestions — Ed stb] 

If you've read this far, thank you. 

— c. keith ray, khis.com 


[Now to your other points. Ouch! “Toy 
problem” eh? We'll see what we can do 
to lean a little more in the practical 
direction. 

When it comes to allowing different 
languages, we have to put some 
limitations on things somewhere so Mike, 
(who’s keeping his day job - now at 
General Magic) has time to try out all of 
the code, profile successful entries, and 
then put the article together. He has the 
tightest deadline of any of our regular 
writers because we want to maintain the 
two month turnaround time between 
printing the problem and printing the 
solution(s). That leaves precious little 
time for him to add any additional 
complexity to handling submissions. 

As for the copyright and ownership 
issue, check out the rules printed with 
this month’s challenge. Authors retain 
ownership, and we get a non-exclusive 
right to publish without limitation. We 
hope you find this helpful. 

We truly appreciate this kind of 
constructive feedback. Please let us know 
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how we're doing as we go. — Ed stb/ 





COMMENTS ON FORMATTING 


As a subscriber I would like to 
thank you and the rest of the staff for 
the ongoing improvements in the 
content of MacTech. Just one 
suggestion: It would be very nice to 
have the source code better formatted 
(e.g. function headers bold - I'm a 
Pascal-ist :-) IMO, C is a hard to read 
language, without any "eye-catching" 
structure inherent. So special formatting 
of key points of the source code could 
be a big plus! 

— Peter Baral, Medienwerkstait 


[You may have already noticed that 
some changes have taken place. If you 
haven’t, take a look throughout this 
issue, and see what you think — Ed stb] 


AS RA SSI ERE OI GETS EL DC TE 


FORMATTING COMMENTS 


I'd like to say that the new format 
of listing comments within code are 
great: very readable and very clear... 

— Victor Lombardi, New York University 


[We'd like to make more improvements, 
but find ourselves limited by how much 
we can do by hand. If any of you have 
tips on how to do more to 
programmatically apply styles to source 
code, we’d love to hear them. Anyone 
out there tried cross-breeding a compiler 
with a word processor? We're also 
interested in your suggestions for 
additional stylistic things we can do to 
present code as clearly as possible. How 
about it, any suggestions? — Ed stb] 


yen 5 2 RE ORE PER NR ET SPSL NS ON NTT I 


DEVELOPMENT ENVIRONMENTS 


I just received the April issue a few 
days ago. The quality and variety of 
articles in addition to contributions by 
Apple and Symantec employees is 
excellent. Over the past year the 


magazine has really improved. 
Coverage of recent and current 
technologies is superb. What I believe 
might be a good idea for an article or a 
theme for an issue would be develop 
environments for PowerPC computers. 

MPW and Symantec THINK 
products used to be the main 
environments for developers, with MPW 
being the more costly and most powerful 
environment. However that has changed. 
Visual programming products in addition 
to CodeWarrior by MetroWerks have 
added a new depth to Macintosh 
development. With the recent release of 
C++ version 7.0, Symantec seems to have 
reversed the cost advantage that the 
THINK products had over MPW. In two 
major releases, THINK C/C++ has 
jumped from a $299 list price to a 
whopping $499. While this article or 
issue should not be a public assault of 
Symantec's pricing policy, it should 
provide developers a good picture of the 
advantages and disadvantages for each 
development environment. 

One item that should be addressed 
is not only development for corporate or 
commercial developers, but also the 
independent developer. This is someone 
who works another job but develops 
Macintosh software in the evenings and 
on weekends. These are usually the 
people with the most original software. 

However, with the current price of 
some development environments, it is 
getting too costly for these people to 
stay on top of the new technologies and 
development products. 

Well, I guess I will get off of my 
little soapbox now. Thanks for a superb 
magazine and keep up the great work. 

— Steven Korize 


[Take a look at the Symantec C++ 7.0 
language review in this issue. It touches 
on a number of the points you make, all 
without a “public assault”. Each tool has 
its advantages — Ed stb] 2 
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Macintosh Drag And Drop continued from page 63 


TRACKING A DRAG 


During a drag, as the user moves the drag items on the 
screen, searching for a destination for the items, the Drag 
Manager sends a sequence of tracking messages to the tracking 
handler for each window that has a registered handler as the 
mouse moves over the window. Our tracking handler is 
responsible for providing all visual feedback to the user 
indicating that the group of items can be dropped in the current 
location. This code is the part of the drag tracking handler from 
Developer VISE. 


pascal OSErr MyTrackingHandler(short message, 
WindowPtr theWindow, 
void *handlerRefCon, 
DragReference theDrag) 


{ short result; 
unsigned short count; 
unsigned short index; 
unsigned long flavorFlags; 
unsigned long attributes; 
ItemReference thelItem; 
RgnHandle theRgn; 
ArchiveWPtr dataPtr = (ArchiveWPtr)handlerRefCon; 
ArchiveWPtr hitDetartr: 


Point theMouse; 
Point localMouse; 
Rect tRect; 

// 


// We decide whether we can accept the data when we are called with 

// a message of dragTrackingEnterHandler. If we can, we set gCanAcceptltems 
// to true. 

// 


if ((message != dragTrackingEnterHandler) 
&& (!gCanAcceptItems)) { 
return (noErr) ; 
} 


GetDragAttributes(theDrag, &attributes) ; 


switch (message) { 
case dragTrackingEnterHandler: 
// 
// by default our window can always accept items 
// 


gCanAcceptItems = true; 


// 

// find out how many items have being dragged 
// 

CountDragItems(theDrag, &count); 


for (index = 1; index <= count; indext+) { 
// 
// get the item reference number for the nth item being dragged 
// 
GetDragItemReferenceNumber(theDrag, index, &thelItem); 


// 

// See if a flavor of flavorTypeHFS exists for this drag item 

// If one does exist, then we can accept this item, so continue 

// checking the rest of the items. 

// An item being dragged from the Finder to our window would qualify 
// as this type. 

// 


result = GetFlavorFlags(theDrag, theItem, 
flavorTypeHFS, &flavorFlags) ; 


if (result == noErr) { 
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continue; 


} 


// 

// See if a flavor of kDragltem (our proprietary flavor) exists. 

// If it does and the drag flags indicate we started the drag then 

// we are simply moving the file in the file list, so we can accept 

// this type. 

// 

result = GetFlavorFlags(theDrag, thelItem, 
kDragItem, &flavorFlags) ; 


if ((result == noErr) 
&& (flavorFlags & flavorSenderOnly)) { 
continue; 
} 
// 


// We couldn’t find and flavors that we wanted so we will not 
// accept the data. 
// 
gCanAcceptItems = false; 
break; 
} 


break; 


case dragTrackingEnterWindow: 


gCursorInContent = false; 
break; 





66 Pe taken pieces of code directly 
from our source to show how easy 
it is to add Drag Manager support 
to your existing application. 





case dragTrackingInWindow: 


// 

// The user is dragging items over our window. 

// We need to determine if we’ve left our window because the Human 
// Interface Guidelines state that no hiliting is to be done until 

// the user drags outside of the sender window. 

// 

GetDragMouse(theDrag, &theMouse, OL); 

localMouse = theMouse; 

GlobalToLocal (&localMouse) ; 


if (attributes & dragHasLeftSenderWindow) { 
// 
// The user has dragged outside of the sender window so we are now 
// free to perform hiliting to indicate whether or not the drag 
// can be accepted by the window. 
// We check to see if the user is dragging into our window, and 
// if so, have we shown the drag hilite? If it is appropriate we 
// will show the drag hilite, meaning the user can drop the drag 
// items here. 
// If the user is not dragging in our window, we check to see if 
// the drag hilite is shown. If it is we hide the drag hilite. 
// 
tRect = (**(dataPtr->ArcList) ).rView;: 
InsetRect(&tRect, 2, 1); 


if (PtInRect(localMouse, &tRect)) { 
if (!gCursorInContent) { 
InsetRect(&tRect, -2, -4); 
tRgn = NewRgn() ; 
RectRgn(theRgn, &tRect); 
ShowDragHilite(theDrag, theRgn, true); 
DisposeRgn(theRgn) ; 
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gCursorInContent = true; 


} 
else { 
if (gCursorInContent) { 
HideDragHilite(theDrag) ; 
gCursorInContent = false; 
} 
} 


// 

// This is our own routine which will return a pointer to a data 

// structure we maintain for each window. 

// We check to see if we are dragging in the sender window. If we 
// are, we call one of our routines to handle hiliting of items in 

// the window, autoscrolling, and other various operations. 

// 

FindDataPtrGivenMousePt(theMouse, &hitDataPtr) ; 


if (hitDataPtr == dataPtr) { 
HandleSameWindowDrag (theWindow) ; 
. 


break; 


case dragTrackingLeaveWindow: 


// 
// Remove window highlighting, if showing. 


if ((gCursorInContent) 
&& (attributes & dragHasLeftSenderWindow)) { 
HideDragHilite(theDrag) ; 


break; 


case dragTrackingLeaveHandler: 
break; 
} 


return (noErr); 


} 


RECEIVING A DROP 


When the user has chosen the destination for the items 
being dragged, the Drag Manager calls the destination window’s 
receive drop handlers to allow your application to request and 
process the drag item flavors it wishes to accept. The following 
code is part of the receive drop handler from Developer VISE. 


pascal OSErr MyReceiveDropHandler(WindowPtr theWindow, void 
*handlerRefCon, DragReference theDrag) 
{ 

unsigned short items; 

short index; 

ItemReference thelItem; 

FlavorFlags theFlags; 


Size dataSize; 

HFSFlavor theHFS; 

OSErr result; 

// 

// find out how many items where dragged 
// 


CountDragItems(theDrag, &items) ; 


for (index = 1; index <= items; indext++) { 
// 
// Get the item reference number for this drag item so we can find out 
// additional information later on. 


// 
GetDragItemReferenceNumber(theDrag, index, &theItem) ; 
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// 

// Get the flavor flags for this object’s flavor of kDragItem. 

// If we can find flags for this flavor, then we know that the drag 

// was completed in the sender window, so what the user did was simply 
// move an item in our file list. 


// 
result = GetFlavorFlags( theDrag, theItem, kDragItem, 
&theFlags) ; 
if ((result = noErr) && (flavorFlags & flavorSenderOnly)) { 
// 
// Move the item that the user dragged to the new location in the file list 
// 
MoveListItem(theWindow, 
((ArchiveWPtr) theWindow) ->ArcnIndexes, gLastLine) ; 
} 
else { 


// it wasn’t a drag from one of our windows, so let’s see if a 

// file system object was dragged to our window. 

// 

// Get the flavor flags for this object’s flavor of flavorTypeHFS 

// 

result = GetFlavorFlags( theDrag, theltem, 
flavorTypeHFS, &theFlags) ; 


if (result == noErr) { 
// 
// lf we are here then the object contained a flavorTypeHFS so we 
// need to know how much data it contains (we really do know how 
// much data is has, but it doesn’t hurt to make this call. 


// 

GetFlavorDataSize(theDrag, theItem, flavorTypeHFS, 
&dataSize) ; 

// 

// Get the actual flavor data 

// 


GetFlavorData( theDrag, theItem, flavorTypeHFS, 
&theHFS, &dataSize, OL); 


// 
// Make sure the window does not have it’s drag hilite showing 


// 
HideDragHilite(theDrag) ; 


// 
// Add the dragged files to our archive 


// 
AddFilesToArchive(theWindow, &theHFS) ; 
} 
} 


return (noErr); 


} 


IMPLEMENTING THE DRAG MANAGER IN A TEXT EDITOR 


My first experience with the Drag Manager was in October 
of last year when I had the opportunity to add Drag Manager 
support to a text editor. I received the source code for the text 
editor and the documentation for Macintosh Drag and Drop and 
was asked to add Macintosh Drag and Drop support. Later that 
same night I had completed implementing all of the features of 
the Drag Manager that were relevant to the text editor. I think 
this is a tribute to just how easy it is to add Drag Manager 
support to your application. The sample code provided with 
Macintosh Drag and Drop makes it incredibly easy to use the 
Drag Manager. 

Dealing with dragging in a text editor deserves a few 


Continued on page 77 
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NATIVE POWERPC FRONTIER 


UserLand Software has announced 
and released a new version of Frontier 
3.0, compatible with the Power 
Macintosh product line. Frontier is one 
of the first “native mode” applications 
to take advantage of the substantial 
new performance made possible by the 
PowerPC chip. Scripts run up to eight 
times faster on a PowerPC than they 
would on a non-RISC processor. 

“We believe this is a significant 
release because scripts now run at 
performance levels comparable with 
compiled C applications on earlier 
processors,” said UserLand President 
and CEO David M. Winer. “Interpretive 
systems like Frontier gain enormously 
from conversion to native mode,” he 
continued. Frontier Threads and the 
Component Manager. 

The new release of Frontier, 
version 3.0.2, is available immediately. 
Registered Frontier 3.0. users can 
purchase the native mode application 
for $139 in the U.S. and Ganada, $159 
elsewhere. The suggested retail price of 
Frontier 3.0 is $495. 





COMPUSERVE MAIL LINKS TO MS- 
MAIL AND POWERTALK 


CompuServe announced two 
extensions for CompuServe members 
using Microsoft Mail and PowerTalk 
programs. The extensions provide 
access to CompuServe Mail and all of 
the services it connects to from those 
applications. 

Users can exchange messages with 
complete retention of their full 
multimedia message structure when 
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communicating with others using a 
compatible package. For example, if a 
Microsoft Mail user creates a message 
incorporating an OLE object and several 
attachments, the user receiving the 
message will see it as exactly as it was 
sent. The same native, full-fidelity, 
message transfer is also available to 
PowerTalk users when communicating 
with each other. 

Both extensions feature the same 
connect scripting language supported 
by CompuServe Information Manager 
user interface software, and 
customizable settings so email can be 
accessed from home, work or remote 
locations. Also included is the capability 
to send and receive messages on 
demand, at pre-set times or when a 
specified number of messages are 
waiting to be sent from the out-basket. 

Both extensions are downloadable 
from tae GO CISSOFT area on 
CompuServe for $5.00 each, with no 
connect rate charged. The fee is offset 
by a $5.00 CompuServe usage credit for 
each extension downloaded. 





AUTOMATED MACINTOSH STRESS 
TESTING 


QC™, an automated test tool, can 
quickly isolate problems in application 
software and code resources that would 
otherwise randomly crash or hang under 
different Macintosh configurations. 
These tests can be performed by non- 
technical personnel with little or no 
knowledge of Macintosh programming. 
Software engineers can take advantage 
of a custom API to achieve pinpoint 
control from directly within their code. 





QC gives developers and Quality Control 


personnel an extensive tool for stress 


testing their application software before 
it’s shipped. 

The software is composed of a 
System Extension and a Control Panel 
for testing application software. QC 
monitors application code for memory- 
related errors, performing common tests 
such as heap scrambling, purging, and 
validation quickly and easily. QC goes 
further to perform Block Bounds 
checking, Block Move validation, Grow 
Lock testing, total free memory 
invalidation, and other tests not 
available in any other tool. By 
performing tests that quickly stress an 
application without regard for what Mac 
hardware is in use, how much memory 
is available, or what System Software 
configuration is in use, QC can save 
time and money through the entire 
development process. Quality Control 
personnel can automatically test 
multiple applications from a predefined 
launch list. They can perform heap 
operations on application and system 
heaps simultaneously. All settings are 
application specific - users can quickly 
test multiple programs with different 
test settings either automatically or by 
hitting a single hot key. 

Software engineers can control all 
aspects of testing from within their own 
code using a complete application 
programming interface (API). Using the 
API they can set and perform specific 
tests and create test suites. API libraries 
and interfaces are available for C and 
C++, using the MPW and Think 
environments. 

QC runs on all Macintosh models 
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with System Software version 7.0 or 
later, and supports balloon help, 32-bit 
addressing, and Virtual Memory. QC is 
compatible with Power Macs. A native 
PowerPC version will be released later 
this year as a free upgrade to existing 
users. A free, fully featured time-out 
demo is available on America Online, 
AppleLink, and CompuServe - contact 
Onyx via email for more information. 
Pricing is $99.95 plus $5.00 shipping 
and handling (within continental 
United States) with discounts for multi 
pack orders. 

For more info, contact: Onyx 
Technology, Brooks Bell, 7811 27th Ave 
West, Bradenton, FL 34209. (813) 795- 
7801, (813) 795-5901 fax. AppleLink: 
D2238; AOL: OnyxTech; CompuServe: 
70550,1377; Internet: onyxtech@aol.com 
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POWER MAC CONFLICT CATCHER 


With the advent of the new Power 
Macintosh™ and Native software 
programs come compatibility questions 
and problems caused by non-Native 
Startup files. [hese non-Native 
programs create "Patchovers" to Native 
code that could adversely affect 
machine performance as much as 30- 
40%. Conflict Catcher II can detect 
these Patchovers. 

Conflict Catcher II can walk the 
user through a conflict test which 
disables compatible startup software 
until only the problem startup file(s) 
remain. Conflict Catcher II tests 
existing startup software and font files 
without relying on databases that 
constantly need updating. Conflict 
Catcher II allows the user to create sets 
of startup software often used in 
conjunction with one another. It also 
allows the user to create links of 
software that must always (or never) 
run together. 

You can run a system report which 
analyzes your Startup Files and marks 
suspected trap patches. You can then 
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create a set of Startup Files which do 
not slow down or adversely affect 
Native applications. 

Instead of completely relying on 
beta sites to report incompatibilities, 
Conflict Catcher If can make many 
incompatibilities known immediately. 
Technical support staff can be assisted 
by Conflict Catcher II's ability to 
generate system reports and pinpoint 
incompatible startup files. 

Retail Price of Conflict Catcher II is 
$79.95. Upgrades: Version 2.0 to 2.1: 
Free upgrades via the Conflict Catcher 
II Updater on America-on-Line. 

If purchased after January 1, 1994, 
upgrades can be obtained from Casady & 
Greene, with proof of purchase, for the 
shipping and handling costs only - $7.50 
U.S. Mainland, $10.95 Canada or Hawaii. 

If purchased prior to January 1, 
1994, uperade cost is $19.95 Us. 
Mainland, $22.95 Canada or Hawaii. 
This price includes shipping and 
handling. 

Version 1.0 to 2.1: Upgrades are 
$29.95 with proof of purchase, through 
Casady & Greene. This price includes 
shipping and handling. 

Competitive Upgrades: $29.95 plus 
shipping and handling with proof of 
purchase of HELP™, ALERT™, INIT 
Manager™, INIT Picker™, NOW 
Utilities Startup Manager™. 

A free, 3-day, fully-working version 
of Conflict Catcher II is available for the 
asking from Casady & Greene or from 
the online services below. 

For more info, call (800) 359-4920 
or fax (408) 484-9218. AOL: 
Casadygree; CompuServe: 71333,616; 
AppleLink: D0063, E-world: Casadyg. 





OBJECT DB FOR MAC, OS/2, AIX 


POET Software 
availability of its object database 
system, POET. It is designed for C++ 
development, and works in mixed 
single and multiuser environments. 


announced 


Version 2.1 sports an improved 
database definition language, 
performance improvements, better low- 
level file I/O, simplified administration 
tools, and an online help system. 
POET is available on 12 different 
operating systems, and supports MPW 
4 C++ and Symantec C++. ‘The 
Macintosh and Windows clients support 
an event notification facility for writing 
event-driven workgroup applications 
across OS boundaries. 

POET Personal Edition for 
Macintosh is available for $499, and the 
Professional Edition is $999. 

For more information, contact 
POET Software Corp at (408) 970-4640. 
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DATA FLOW DIAGRAMMER 


CSA announced an improved 
version of SILVERRUN-DFD with a 
variety of options for changing the 
graphical presentation of data flow 
diagrams. Version 2.2 offers user- 
defined fields with graphical display 
options; changeable process shapes, 
external entities, or stores; and 
customizable process frames. 

SILVERRUN is an advanced 
development workbench with an 
intuitive user interface and an 
embedded expert system to help 
modelers create quality business 
models. It employs object-oriented 
extensions to establish business rules 
within the database design. 

It allows dynamic simulation of 
business processes and the creation of 
process trees. It has support for a 
relational dictionary, allowing users to 
save and load the contents of a model 
dictionary in a database. 

SILVERRUN-DFD runs on 
Macintosh, Windows 3.x, and OS/2. It’s 
available for $2500. 

For more information, call (800)- 


537-4202. 
& 


eo, 
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D eveloper Job Oppor tunities | Wyeth-Ayerst Laboratories, a Division of Fortune 100 


American Home Products Corporation, currently has an 





If you are a Macintosh developer, you should register with opportunity available for a Macintosh Applications _ 
us! We have a database that enables us to let you know hated at ie pharmaceutical research facility in 
about job opportunities. When we are asked to do a search sigue ne for designing, coding, docu 
By : client Cheese the database = hates place bbe oe menting and training for multi-platform Client/Server appli- 

ere 1S no Charge tor registering. Ihe database service is : Cations interacting with micro and mini-computer systems 
free. Geographic Coverage is nationwide. : involved in the sharing of biological and chemical informa- 

grap g : 
: tion on a worldwide basis. 

Marketability Assessment - To get a specific feel for your Requirements include a BS/BA degree in Computer 















Science, Engineering or a scientific discipline; strong tech- 
nical background in Macintosh application development 
languages; experience in applications programming, and 
the ability to independently direct and coordinate project 
development. Familiarity with CASE tools a plus. 
Advanced degrees are highly desirable. 


Wyeth-Ayerst offers competitive salaries and 
excellent benefits. Candidates should send 
resume to: WYETH-AYERST RESEARCH, Human 
Resources Department, Position #TMT-709, CN 
8000, Princeton, NJ 08543-8000. Equal 
Opportunity Employer, M/F/D/V. 


VAI 


marketability send a resumé via Email or call. You may 
also request a Resume Workbook & Career Planner. 


Discreet - We are very careful to protect the confidentiality 
of a currently employed developer. 


Scientific Placement is managed by graduate engineers, 
We enjoy a reputation for competent & professional job 
placement services and we are Mac fanatics. 


1-800-231-5920 | AppleLink: D1580 | 713-496-6802 fax 


Scientific Placement, Inc. 








Dept. MT MacRegistr Dept. MT MacRegist Dept. MT MacRegist 

PO. Box 19949 : PO. Box 71 ee PO. Box 4270 ie 

Houston, Texas 77224 San Ramon, CA 94583 Johnson City, TN 37602 . : 

(713) 496-6100 510-733-6168 (615) 854-9444 Leading The Way for a Healthier World 
Ne das @scientific.com bge @scientific.com rjg @scientific.com ) 








Software Marketing 





You've developed an 
excellent product... 
Doesn't it deserve 
excellent marketing? 


The small company specialists. 
Public relations, brochures, direct 
mail, ads, documentation, and more. 
Marketing does not need to be 


expensive! e 
Call for O bis 
Pricing & 

Samples CInc 


Phone 708-752-0220 
Wheaton, IL ¢ Fax 708-752-0222 






Do you 
have used 
equipment 

to sell? 


Or do you want to 
purchase used 
equipment? 






Do you have a 
Service... 


that you want to advertise 
to over 30,000 Macintosh 
programmers and developers? 








Advertise it in the 
Classified Section 
of MacTech 
Magazine. Call 
Ruth Subrin at 
310/575-4343 
to find out how to 
place your ad. 


Do it in the 


MacTech Magazine Classifieds — an 


inexpensive vehicle that gets results. 


Call Ruth Subrin at 310/575-4343 


to reserve space NOW! 
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MACINTOSH 
PROGRAMMER/ 
ANALYST 


The New York Times, a fortune 
500 publisher located in New 
York City, is seeking a junior 
Macintosh Programmer/Analyst 
to help support our 200+ node 
network. We require one to 
two years programming 
experience with C/C++ and the 
Mac Toolbox. Other valuable 
skills include: 
e System level Scripting 
(Frontier, AppleScript) 
e Electronic Publishing 
e Database Design 
We offer the latest hardware and 
software tools, an exciting 
midtown Manhattan location and 
an attractive salary and benefits 
package. If interested, please 
submit your resume in 
confidence to: Mr. Gordon Rust, 
The New York Times, 229 West 
43rd Street, New York, NY 
10036 


Hiring C++ Programmers 
c Cc 


MacxXperts is a growing and 
dynamic company. We create 
commercial software and leading edge 
custom corporate applications. 

We have immediate openings 
for people who are experienced 
MacApp programmers and for C++ 
programmers who want to learn 
MacApp or NTK. 

Macxperts has an excellent 
development environment with the 
latest hardware and software tools, 
plus a full benefits package, and 
competitive salaries. Our positions 
offer a combination of diversity and 
long-term security. 

Send résumé to: 


MacxXperts AppleLink: 
3228L West Cary Street Xperts 
Richmond, VA 23221 

Phone: 804-353-7122 AOL: 
Fax: 804-358-3847 MacxXperts 





To receive information 
on any products 
advertised in this issue, 


send your request 
via Internet: 
productinfo@xplain.com 
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It’s called the 
Big Apple for a reason. 


In the heart of Wall Street, there is one company whose commitment to Macintosh 
development is as impressive as its leadership in global finance—J.P. Morgan. 





Few companies, in fact, can match the sheer range of our new development efforts 
or the phenomenal pace at which our client base of 2,000+ Macs continues to 
expand and evolve. The result is a highly creative climate in which smart, 
independent thinkers can find genuine challenge and cultivate new proficiencies. 


For developers of all levels—from associates to team leaders—there are immediate 
opportunities to drive innovation in object-oriented development and global 
computation across diversified business areas. Senior members will set direction in 
training and resource allocation by sharing their expertise on multiple projects. 
Associates will apply their skills to a broad range of projects that include software 
design, analysis and development. 


All contributors to our cutting-edge efforts must have solid C programming skills 
and a comprehensive knowledge of the Macintosh Toolbox. Experience with C++, 
Galaxy, Smalltalk and Omnis are a strong asset, but not required. 


To realize your full potential at J.P. Morgan, an equal opportunity employer offering 
performance based compensation and benefits including profit sharing, flexible 
benefits, and tuition reimbursement, please send your resume, with salary history, in 
confidence, to: Thomas J. Collins, Vice President, Dept MT, J.P. Morgan, 60 Wall 
Street, New York, NY 10260-0060. Fax number (212) 235-4888. We will 
acknowledge only those candidates who meet the criteria outlined above. 


JPMorgan 


¢ YOUR RECRUITMENT AD HERE” 


opportunites section, The 
Classifieds. Whether pub set or 
your display ad, this is the direct 
approach to Macintosh 
programmers and developers. 


Make direct contact with over 
30,000 Macintosh programmers 
and developers by placing a low 
cost classified recruitment ad in 
MacTech Magazine’s career 


For more information about placing your ad, 
call Ruth Subrin at 310/575-4343. 
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If you have a CD-ROM 
drive, then you've 
gotta have 

every article published 
in the first 8 years of 
MacTech Magazine, 
including all of 1992. 
Over 900 articles. 

All 95 issues. 

All the source code. 
THINK Reference 2.0 
Cie wAl 
Working applications. 
Full documentation. 
Demos for developers. 
Free shareware code. 


Plus, Plus, Plus. 





“Any registered u§er Who purchases All of MacTech Magazine 
CD-ROM Volume ¥-8 after November 1, 1993 will receive a 
free upgrade to the next version of the All of MacTech 
Magazine CD-ROM when available. 


\ Formerly MacTutor 
AGAZINE” 


FOR MACINTOSH PROGRAMMERS & DEVELOPERS 





Voice: 310/575-4343 ¢ Fax: 310/575-0925 
AppleLink: MT.CUSTSVC ¢ CompuServe: 71333,1063 
Internet: custservice@xplain.com 
America Online & GEnie: MACTECHMAG 


In The MacTech 
Magazine Folder 


Every article published in 
the first 8 years 

Complete source code & 
working examples: 
Assembly, Pascal, C, 
FORTRAN, BASIC, Lisp, 
MacScheme, Forth, Neon, 
MOPS, Yerk, Prograph, 
Hypercard, Ada, 4th 
Dimension, MacApp, 
THINK Class Library 
Complete text of articles 
including dialogs, custom 
windows and menus, 
sounds, viruses, object 
oriented programming, 
animation, simulations, 
XCMDs and XFCNs, 
parsing, User Interface 
Design, List Manager, Class 
Libraries, debugging, 
product reviews, inits, 
control panel devices. 
Special ViewR document 
reader to view, search and 
print articles. 

And much more! 


THINK™ Reference 


Symantec’s THINK 
Reference 2.0. Complete 
on line guide to Inside 
Macintosh, VoL LVI, with 
cross referenced index, 
detailed information of 
each function, procedure 
and detail needed when 
programming the 
Macintosh. 


SYMANTEC, ~ 








In The Apple Folder 
“Up Your FCBs” 
BitMapToRegion 
CD-ROM 3.2 
Discipline 
EXEC 
MacsBug 06.2.2 
Basic Connectivity Set 
w/Communications Toolbox 
system 7.0.1 with Tune-up 
Logic Manager 1.0d2 
Reshait.2:1, 1+ 
QuickTime 1.5 
And much more! 


Use it to index all your 
references in seconds on 
multiple disks whether or 
not the disk is mounted. 





Demos relevant to 
developers 
Demos for all kinds of third 
party tools and utilities 


Public/Shareware Code 
150+ meg, most are fully 
documented, including 
many updates 
Best of BMUG’s 
Programming Tools, System 
7 Utilities, etc. 

Hundreds of code ideas, 
explanations, help files 
Tutorials 

Source code for more than 
70 working applications 
And much, much more! 


More! More! More! 

We could go on listing 
everything that is included on 
this new exciting CD-ROM. 
But you should see it for 
yourself. Order yours today, 
for $299 (upgrades for $150) 
plus shipping & handling. 
Call, fax, or e-mail for more 
information. 








E-mail, Fax, write, or call us. You may use your VISA, MasterCard or 
American Express; or you may send check or money order (in US funds only): 
MacTech Magazine, P.O. Box 250055, Los Angeles, CA 90025-9555. 

Voice: 310/575-4343 © Fax: 310/575-0925 


If you are an e-mail user, you can place orders or contact customer service at: 


e AppleLink: MT.CUSTSVC 

¢ CompuServe: 71333,1063 

e Internet: custservice@xplain.com 
e America Online: MT CUSTSVC 
e GEnie: MACTECHMAG 


SUBSCRIPTIONS 

US Magazine: $47 for 12 issues 

Canada: $59 for 12 issues 

International: $97 for 12 issues 

Domestic source code disk: $77 for 12 issues 
Int'l source code disk: $97 for 12 issues 


CD-ROM 

All of MacTech Volumes LVI CD-ROM: Includes over 900 articles from all 95 
issues (1984-1992) of MacTech Magazine (formerly MacTutor). All article text and 
source code. Articles and code are indexed by On Location. The CD includes 
Symantec's THINK™ Reference 2.0, On Technology's On Location™ 2.0, working 
applications with full documentation, product demos for developers and more. 
See advertisement, this issue: $299. Upgrades $150, e-mail, call or write for info. 


BOOKS 

The Best of MacTutor, Volume 1: Sold Out 

The Complete MacTutor, Volume 2: Sold Out 

The Essential MacTutor, Volume 3: $19.95 

The Definitive MacTutor, Volume 4: $24.95 

The Best of MacTutor, Volume 5: $34.95 

Best of MacTutor Collection, Volumes 3 - 5: $69 

Best of MacTutor, Volumes 6, 7, 8 & 9: Not available 


DISKS 
Source Code Disks: $8 each 
Topical Index (1984-1991) on disk: $5 


MAGAZINE BACK ISSUES 
Volumes 3, 4, 5, 6, 7, 8, 9 and 10: $5 each (subject to availability) 


SHIPPING, HANDLING & TAXES 
California: 

Source disk or single issue: $3 

Single book or multiple back issues: $5 
Two books: $8 ¢ All other orders: $12 


California residents include 8.25% sales tax on all software, disks and books. 


Continental US: 

Source disk or single issue: $3 

Single book or multiple back issues: $7 
Two books: $15 ¢ All other orders: $17 


Canada, Mexico and Overseas: Please contact us for shipping information. 


Allow up to 4 weeks for back issues. Allow 2-4 weeks delivery for all other orders. 


PLEASE NOTE 

Source code disks and journals from MacTech Magazine are licensed to the purchaser 
for private use only and are not to be copied for commercial gain. However, the 
code contained therein may be included, if properly acknowledged, in commerci | 
products at no additional charge. All prices are subject to change without notice. 
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Defying Gravity: The 
Making of Newton Doug 
Menuez and Markos Kounalakis. An 
in depth, dramatic account of the 
story of Newton’s creation. It is a 
technological adventure story; a 
fascinating case study of the process 
by which an idea is born and then 
translated into a product on which 
careers and fortunes can be made or 
lost. It is a new kind of business 
book, one that captures through 
powerful photo-journalism and a fast- 
paced text, the human drama and risk 
involved in the invention of a new 
technology for a new marketplace. 


196 pgs., $29-95 $26.96 


The Elements of E-Mail 

Style Brent Heslop and 
David Angell. Learn the rules of the 
road in the e-mail age. Concise, easy- 
to-use format explaining essential e-mail 
guidelines and rules. It covers style, 
tone, typography, formatting, politics 
and etiquette. It also outlines basic 
rules of composition within the special 
context of writing e-mail and includes 
samples and templates for writing 
specific types of e-mail correspondence. 


208 pages. $4495 $13.45 


How To Write Macintosh Software. 
Scott Knaster. The debugging 
reference for the Macintosh. 3rd ed. 


448 pgs., $28-95 $26.05 


The Instant Internet 

Guide Brent Heslop and 
David Angell. An Internet jump-start 
— how to access, use and navigate 
global networks. The Instant Internet 
Guide equips readers with the tools 
needed to travel the electronic world. 
The book highlights the most 
important sources of Internet news 
and information and explains how to 
access information on remote systems. 
It outlines how to use essential 
Internet utilities and programs and 
includes a primer on UNIX for the 


Internet. 224 pages $4495 $13.45 


Learn C on the Macintosh by Dave 
Mark. This self-teaching book/disk 
package gives you everything you 
need to begin programming on the 
Macintosh. Learn to write, edit, 
compile, and run your first C 
programs through a series of over 25 


projects that build on one another. 
The book comes with THIN C, a 
customized version of Symantec’s 
THINK C, the leading programming 
environment for Macintosh: 464 


pages, Book/disk: $3495 $31.45 


Macintosh C Programming Primer 
Volume I, Second Edition, Inside 
the Toolbox Using THINK C, by 
Dave Mark and Cartwright Reed. 
This new edition of this Macintosh 
programming bestseller is updated to 
include recent changes in Macintosh 
technology, including System 7, new 
versions of THINK C and ResEdit, and 
new Macintosh machines. Readers 
will learn how to use the resources, 
Macintosh Toolbox and interface to 
create stand-alone applications. 672 


pages, $26-95 $24.24 


Learn C++ on the Macintosh by 
Dave Mark. Includes a special 
version of Symantec C++ for 
Macintosh. Book/disk package with 
3.5” 800K Macintosh disk. 400 
pages, $3695 $33.26 


Macintosh C Programming 
Primer Volume II, Mastering the 
Toolbox Using THINK C, by Dave 
Mark. Volume II picks up where 
Volume I leaves off, covering more 
advanced topics such as: Color 
QuickDraw, THINK Class Library, 
TextEdit, and the Memory Manager: 
528 pgs. $2695 $24.25 


Macintosh Pascal Programming 
Primer Volume I, Inside the 
Toolbox Using THINK Pascal, by 
Dave Mark and Cartwright Reed. This 
tutorial shows programmers new to 
the Macintosh how to use the 
Toolbox, resources, and the Macintosh 
interface to create stand-alone 
applications with Symantec’s THINK 
Pascal. 544 pages $2695 $24.25 


Macintosh Programming 

Techniques by Dan Sydow 
(Series Editor: Tony Meadow) This 
tutorial and handbook provides a 
thorough foundation in the special 
techniques of Macintosh program- 
ming for experienced Macintosh 
programmers as well as those 
making the transition from DOS, 
Windows, VAX or UNIX. Emphasizes 
programming techniques over syntax 
for better code, regardless of 
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language. Guides the reader through Macintosh 
memory management, QuickDraw, events and more, 
using sample program in C++. Disk includes an 
interactive tutorial, plus reusable C++ code. $34.95 


Software By Design: Creating User 

Friendly Software by Penny Bauersfeld 
(Series Editor: Tony Meadow) This excellent 
reference provides readers with a thorough how-to 
for designing software that is easy to learn, 
comfortable to operate and that inspires user 
confidence. Written from the perspective of 
Macintosh, but compatible with all platforms. 
Stresses user input from initial design, through 
prototyping, testing and revision. Provides tools for 
analyzing user needs and test responses. Includes 
exercises for sharpening user-oriented design skills. 


$29.95 


Programming in Symantec C++ for 

the Macintosh by Judy May and John 
Whittle. This book will introduce you to object- 
oriented programming, the C++ language, and of 
course Symantec C++ for the Macintosh. You don’t 
have to be a programmer, or even know anything 
about programming to benefit from this book. 
Programming in Symantec C++ for the Macintosh 
covers everything from the basics to advanced 
features of Symantec C++. If you are a Think C or 
Zortech C++ programmer who wants to learn more 
about object-oriented programming or what’s 
different about Symantec C++, there are whole 
chapters specifically for you. Includes helpful 
examples of C++ code that illustrate object-oriented 
programs. $29.95 


Programming for System 7 Gary Little and Tim 
Swihart. 384 pages $26-95 $24.25 


ResEdit™ Complete, Second Edition Peter 

Alley and Carolyn Strange. With ResEdit, 
Macintosh programmers can customize every aspect 
of their interface form creating screen backgrounds 
and icons to customizing menus and dialog boxes. 
608 pages. Book/disk package. $3495 $31.45 


Sad Macs, Bombs, Disasters and What to 
Do About Them Ted Landau. 640 Pages 
$24-95-$22.45 


Writing Localizable Software for the Macintosh 
Daniel R. Carter. 469 pages. $2695 $24.25 





THE APPLE LIBRARY 





HyperCard Stack Design Guidelines Apple 
Computer, Inc. 240 pages, $295 $19.95 


Inside AppleTalk Gursharan S. Sidhu, Richard F. 
Andrews and Alan B. Oppenheimer. Apple 
Computer, Inc. 650 pages, $3495 $31.45 


Inside Macintosh: Files describes the parts of the 
operating system that allow you to manage files. It 
shows how your application can handle the 
commands typically found in a File menu. It also 
provides a reference to the File and Alias Managers, 
the Disk Initialization and Standard File Packages. 


510 pgs, $29-95 $26.95 
Inside Macintosh: Macintosh Toolbox Essentials 
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covers the heart of the Macintosh. The toolbox 
enables programmers to create applications 
consistent with the Macintosh "look and feel", This 
book describes Toolbox routines and shows how to 
implement essential user interface elements, such as 
menus, windows, scroll bars, icons and dialog 


boxes. 880 pages $3495 $31.45 


Inside Macintosh: More Macintosh Toolbox covers 
other Macintosh features such as how to support copy 
and paste, provide Balloon Help, play and record 
sound and create control panels are covered in this 
volume. The managers discussed include Help, List, 
Resource, Scrap and Sound. $3465 $31.46 


Inside Macintosh: Memory describes the parts of 
the Macintosh operating system that allow you to 
manage memory. It provides detailed strategies for 
allocating and releasing memory, avoiding low- 
memory situations, reference to the Memory 
Manager, the Virtual Memory Manager, and 
memory-related utilities. 296 pages, $2495 $22.45 


Inside Macintosh: Networking This book 

describes how to write software that uses 
AppleTalk networking protocols. It describes the 
components and organization of AppleTalk and how 
to select an AppleTalk protocol. It provides the 
complete application interfaces to all AppleTalk 
protocols, including ATP (AppleTalk Transaction 
Protocol), DDP (Datagram Delivery Protocol), and 
ADSP (AppleTalk Data Stream Protocol), among 
others. $29-95 $26.95 


Inside Macintosh: Overview is the first book that 
people who are unfamiliar with Macintosh 
programming should read. It gives an overview of 
Macintosh programming fundamentals and a road 
map to the New Inside Macintosh library. Inside 
Macintosh: Overview also covers various 
programming tools and languages, compatibility 
guidelines and an overview of considerations for 
worldwide development. 176 pages, $22:95 $20.65 


Inside Macintosh: Processes describes the parts 
of the Macintosh operating system that allow you to 
control the execution of processes and interrupt 
tasks. It shows in detail how you can use the 
Process Manager to get information about processes 
loaded in memory. It is also a reference for the 
Vertical Retrace, Time, Notification, Deferred Task, 
and Shutdown Managers. 208 pages, $2295 $20.65 


Inside Macintosh: QuickTime for anyone who 
wants to create applications that use QuickTime, 
the system software that allows the integration of 
video, animation, and sounds into applications, this 
book describes all of the QuickTime Toolbox 
utilities. In addition, it provides the information 
you need to compress and decompress images and 


image sequences. $29-95 $26.95 


Inside Macintosh: Text describes how to perform 
text handling, from simple character display to 
multi-language processing. The Font, Script, Text 
Services, and Dictionary Managers are all covered, 
in addition to QuickDraw text, TextEdit, and 
International and Keyboard Resources. $39-05 
$35.95 


Inside Macintosh: QuickTime Components 
covers how to use and develop QuickTime 


components such as image compressors, movie 
controllers, sequence grabbers, and video digitizers. 


$3405 $31.46 


Inside Macintosh: Interapplication Communi- 
cation shows how applications can work together. 
How your application can share data, request 
information or services, allow the user to automate 
tasks, communicate with remote databases, $3405 
$31.45 

Inside Macintosh: Imaging covers QuickDraw 

and Color QuickDraw. The book includes 
general discussions of drawing and working with color. 
It describes the structures that hold images and image 
information, and the routines that manipulate them. 
It also covers the Palette, Color, and Printing 
Managers, and the Color Picker, Color Matching, 
and Picture Utilities. $26-95 $24.25 


Inside Macintosh: PowerPC System 

Software describes the new process 
execution environment and system software 
services provided with the first version of the 
system software for Macintosh on PowerPC 
computers. It contains information you need to 
know to write applications and other software that 
can run on the PowerPC. PowerPC System 
Software shows in detail how to make your 
software compatible with the new run-time 
environment provided on PowerPC-based 
Macintosh computers. It also provides a complete 
technical reference for the Mixed Mode Manager, 
the Code Fragment Manager, and the Exception 
Manager. $2245 $20.20 





LANGUAGES 





CodeWarrior™ 
Penta CD by Metrowerks 

is actually a series 
of 3 CDs — Bronze, Silver and Gold. 
These CDs contain the CodeWarrior 
development environment including 
C++, C and Pascal compilers; high- 
speed linkers; native-mode interactive debuggers; and a 
powerful new application framework called PowerPlant 
for rapid Macintosh development in C++. Bronze 
generates 680x0 code. Silver generates PowerPC code. 
Gold generates both 680x0 and PowerPC code. All 
versions will be upgraded for free to 1.0 when it becomes 
available. Bronze: $199, Silver: $299, Gold: $399. 


FORTRAN by Language Systems is a full-featured 
ANSI standard FORTRAN 77 compiler that runs in 
the Macintosh Programmers Workshop (MPW). All 
major VAX extensions are supported as well as all 
major features of Cray and Data General FORTRAN. 
FORTRAN creates System 7 savvy applications 
quickly and easily. Compiler options specify code 
generation and optimization for all Macintoshes, 
including special optimizations for 68040 machines. 
Error messages are written in plain English and are 
automatically linked to the source file. The runtime 
user interface of compiled FORTRAN programs is 
fully customizable by programmers with any level 
of Macintosh experience. $595. w/o MPW: $495. 
Corporate 5 pack $1575 


NEW for 





metrowerks 





MacFortran II by Absoft Corp. A Fortran 


Want more product info? Call us at 310/575-4343. 
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compiler. New front-end design, actually a robust 
superset of ANSI FORTRAN 77. Code generator 
takes full advantage of the fast addressing modes 
of the 68020/030 CPU: $595. MacFortran II for 
A/UX: $695 


SmalltalkAgents™, a superset of the Smalltalk 
language, is fully integrated with Macintosh, 
incorporating design features specifically for the RISC 
and Macintosh System 7™ architecture. 
SmalltalkAgents is a true object oriented workbench 
that includes an incremental and extensible compiler, 
an array of design and cross reference tools, pre- 
emptive interrupt driven threads and events, an 
extensive class library including classes for general 
programming, classes for the Macintosh© user 
interface and classes for the Macintosh operating 
system. Integration of components in enterprise 
systems is simplified with the network, 
telecommunication, and _ inter-application 
communication libraries. The SmalltalkAgents’ 
extensive class library and add-on components make 
it especially well suited as a development workbench 
for custom applications in business, education, 
science, engineering, and academic research. $695.00 


SAVINNGES GN 


NEW!) Symantec C++ for Macintosh is an object- 
oriented development environment 


designed for professional Macintosh programmers. 
Symantec C++ features powerful object-oriented 
development tools within a completely integrated 
environment. The C++ compiler, incremental linker, 
THINK Class Library, integrated browser, and 
automatic project management give Symantec C++ 
fast turnaround times. This product supports multiple 
editors and translators, so you can use your favorite 
tools and resource editors as well as scripts you've 
written within the environment. And with ToolServer, 
you'll be able to customize menus and attach scripts 
based on Apple events, AppleScript, and MPW Tools. 
The built-in SourceServer provides a source code 
control system, allowing teams of programmers to 
solve tough problems faster. With SourceServer, 
you'll always know you're working on the latest 
version. And you'll have old versions at your 
fingertips when code "breaks" and you need to look 
back at modifications. Product Contents: Three high 
density disks, an 832-page user manual, a 568-page 
THINK Class Library and a 100-page C++ Compiler 
Guide. $369.00 


THINK C v. 6.0 by Symantec Corporation 

THINK C is easy to use and highly visual, 
making it the No. 1 selling Macintosh programming 
environment. Version 6.0 enhancements make this 
product faster and more versatile than ever, 
improving your productivity with more powerful 
project management, a full set of tools, and script 
support for major script-based languages. With the 
THINK environment, you spend less time on routine 
programming tasks due to an extremely fast compiler 
and incremental linker. In addition, the automatic 
project manager saves you time by tracking changes 
to your files and recompiling only those that have 
changes. All the tools you need--a multiwindow 





editor, compiler, linker, debugger, browser, and 
resource editor--are completely integrated for speed 
and ease of use. One of the most valuable of these 
tools is the THINK Class Library, a set of program 
building blocks that gives you a head start in writing 
object-oriented applications. And with the new open 
architecture, you can use your favorite tools, resource 
editors, and scripts within the environment. THINK C 
is the logical next step for programmers who have 
worked in HyperCard or other script-based 
development environments. The environment 
supports AppleScript, Apple events, and Frontier, so 
you can link and automate complex, multi-project 
operations. Product Contents: Four Macintosh disks, 
an 832-page user manual, and a 568-page THINK 
Class Library Guide.Price: $219.00 


THINK Pascal v. 4.0 by Symantec Corporation. 

Professionals and students will welcome this 
version of THINK Pascal. It is fully integrated for 
rapid turnaround time and lets you take advantage of 
System 7 capabilities. Features include support for 
large projects, enhanced THINK Class Library, System 
7 compatibility, superior code generation, and smart 
linking. Product Contents: Four Macintosh disks, a 
562-page user manual, and a 498-page object-oriented 
programming manual. $169.00 





UTILITIES 





CommcControl™ by Faceware supports access to 
the Mac Comm Toolbox in ViewlIt windows, 
including program-based and user-oriented tool 
selection and configuration, plus commands for 
direct I/O. Requires Viewlt. $95 


BBEdit 2.5 by Bare Bones Software is the 

text editor for programmers and other 
technical users. This fast, powerful, yet easy to use 
editor features integrated support for THINK C 6.0, 
THINK Reference 2.0 and MPW ToolServer. 
BBEdit's features (among other things) splittable 
editing windows, Show Invisibles, integrated 
Compare, assorted text transformations, fast search 
and replace (with optional "grep" matching), and 
multi-file searching (including THINK C or THINK 
Pascal projects). BBEdit's proven capabilities and 
track record of performance, polish, and reliability 
make it the general-purpose editor of choice 
among professionals and hobbyists alike. $99.00 


C Programmer’s Toolbox/MPW Rev. 3.0 by 
MMCAD. The C Programmer's Toolbox provides a 
wealth of programming and documentation support 
tools for developers who are creating new code, 
porting existing code, or trying to improve and 
expand existing code. The tools include: CDecl 
composes and translates C/C++ declaration 
statements to/from English; CFlow™ determines 
program function hierarchy, runtime library 
contents, function/file interdependencies and graphs 
all or part of a program's functional structure; 
CHilite™ highlights and prints C/C++ files; CLint™ 
semantically checks multiple C source files, 
identifying potential programming bugs, CPrint™ 
reformats, beautifies and documents C/C++ source 
files; and more... Works with MPW C/C++, THINK 
C, requires Apple's MPW. $295 


Want more product info? Call us at 310/575-4343. 
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NEW! CLimate by Orchard Software is a command 

line interface that lets you communicate with 
your Macintosh using English commands to create, 
delete, rename, and move files and folders. It can 
start applications, format disks, restart your 
computer, etc. CLImate supplements the Finder. It 
includes a BASIC interpreter that lets you script your 
Macintosh without AppleScript. The interpreter 
includes advanced programming constructs: repeat 
loops, if/then/else conditionals, subroutine calls, 
etc... CLImate implements wildcard characters, 
enabling you to work on groups of files. Use 
CLImate instead of MPW to manage your projects. 
CLImate is an application occupying 70K disk 
space. It comes bundled with sample programs and 
full documentation. $59.95 


CMaster 2.0 by Jersey Scientific installs into 

THINK C 5 / 6 / 7 and Symantec C++ for 
Macintosh, and enhances the editor. Use its function 
popup to select a function and CMaster takes you right 
to it. Other features include multiple clipboards and 
markers, a Function Prototyper, and a GoBack Menu 
which can take you back to previous editing contexts. 
Almost all features bindable to the keyboard, along 
over a hundred keyboard-only features like “Add New 
Automatic Variable.” Glossaries, AppleScript and 
ToolServer support, Macros, and External Tools you 
create too! $129.00 


Cron Manager by Orchard Software 

implements the UNIX Cron facility. It can 
open any Macintosh file on a given date and time. 
By creating an alias, renaming it to the date and 
time to open, and moving it into the special Cron 
Events Folder, Cron Manager will open it. Cron 
Manager is a control panel that creates the special 
Cron Events Folder inside your System Folder. It 
is completely transparent to the user. It works like 
the Startup Items folder, only smarter. It works 
with any Macintosh file: if you can double-click to 
start it, Cron Manager can open it. $26.95 Cron 
Manager bundled with CLImate, $59.95 


Dialog Maker by Electric Software 

Corporation. Migrating from C to C++? 
Dialog Maker can ease your transition. Dialog Maker 
is an object-oriented programming library for MPW™ 
C++ and Symantec™ C++ (MPW™ and Symantec 
Development Environment versions) which contains 
a complete set of routines that create a high level 
interface to dialogs. Dialog Maker provides a small 
number of simple, yet powerful routines to access 
and manipulate dialogs. Resources are used to 
control the most common dialog behavior allowing 
you to develop your application lightening fast. 
Minimum requirements System 7.0, MPW™ 3.2, 
MPW™ C++ 3.2, or Symantec™ C++ 6.0. $149 


DocuBase™ by Faceware library is a combined 
database and complex document manager. Variable 
or fixed-length records, multiple logical files, 
unlimited indices, multiple key types, optional data 
compression. $95 


EditControls™ by Faceware supports high- 
capacity text, graphic and array-editing controls in 
Viewlt windows. Includes support for file handling 
and printing of text, pictures and numbers. 
Requires Viewlt. $75. 
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EnterAct by Dynabyte is an enhanced C editor 
providing spell-tolerant information retrieval for all top- 
level terms in THINK C and the toolbox, with project 
window for full file management: $149 


InstallerPack™ by Stepup Software is a package of 
several Installer “atoms” that let developers 
incorporate graphics, sounds, file compression and 
custom folder icons into installation scripts. 
Compression formats supported are Compact Pro & 
Diamond. Each atom also available separately: $219 


Last Resort Programmer's Edition records 

every keystroke, command key and mouse 
event (in local coordinates) to a file on your hard 
disk. This is especially useful for program testing & 
debugging, and for technical support and help desks. 
If something goes wrong (because of a power failure, 
system crash, forgetting to save or deleting lines) and 
you lose a word, phrase, or document you can look 
in the Last Resort keystroke file and recover what you 
typed. Last Resort is also useful for technical support 
personnel, when they have to ask, "What was the last 
thing you did before...2" $74.95 


Spellswell 7 1.0.4 is an award-winning, 

comprehensive, practical spelling checker 
that works in batch mode or within applications that 
incorporate the Apple Events Word Services protocol, 
such as Eudora, Word Perfect, Communicate!, and 
Fair Witness. Spellswell 7 checks for spelling errors 
as well as common typos like capitalization errors, 
spaces before punctuation, double double word 
errors, abbreviation errors, mixed case errors, extra 
spaces between words, a/an before vowel/consonant, 
etc... Mac Tech orders include developer kit with 
Writeswell Jr., a sample Apple Events Word Services 
word-processor and its source code. $74.95 


MacAnalyst by Excel Software supports 

software engineering methods including 
structured analysis, data modeling, screen 
prototyping, object-oriented analysis, and data 
dictionary. This language independent tool is 
used by system analysts and software designers. 
Demo $79 Product $995 


MacAnalyst/Expert by Excel Software 

supports software engineering methods 
with the capabilities of MacAnalyst plus state 
transition diagrams, state transition tables, 
decision tables and process activation tables. An 
integrated requirement database provides 
traceability from requirement statements to 
analysis or design diagrams, code or test 
procedures. This tool is well suited to the 
analysis and design of real-time or requirements 
driven projects. Demo $79 Product $1595 


MacDesigner by Excel Software supports 

software engineering methods including 
structured design, object-oriented design, data 
dictionary and code browsing. This tool is well 
suited to detailed design or maintenance of 
software development projects. Demo $79 
Product $995 


MacDesigner/Expert by Excel Software 
supports software engineering methods 
with the capabilities of MacDesigner plus multi- 
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task design. An integrated requirement database 
provides traceability from requirement statements 
to design diagrams, code or test procedures. This 
tool is well suited to design or maintenance of 
real-time, multi-tasking software projects. Demo 
$79 Product $1595 


MacA&D by Excel Software combines the 

capabilities of MacAnalyst/Expert and 
MacDesigner/Expert into a single application. It 
supports structured analysis and design, object- 
oriented analysis and design, real-time extensions, 
task design, data modeling, screen prototyping, 
code editing and browsing, reengineering, 
requirement traceability, and a global data 
dictionary. Demo $149 Product $2995 


MacGadgets™ is a Human Interface Design Kit that 
gives your application a striking three-dimensional, 
gray-scale appearance. In addition, MacGadgets 
contains a set of graphical devices which are not 
built into the Macintosh. All of the devices 
contained in MacGadgets are resources. Includes 
complete source code and instruction manual: $195 


MacWireFrame by Amplified 

Intelligence. Create your own virtual 

reality application with MacWireFrame, a 

virtual reality application frame work. 
Includes a complete library of object oriented 
graphics routines, its own easy to understand 
application frame work (similar to MacApp or TCL 
but a lot easier to understand), plus an example 
application program that lets you start solid 
modeling right away. Comes complete with fully 
documented source code. Due to the overwhelming 
response the special price offer has been extended 
for a little while longer. Special Offer: $299.00 
$75!!! All new purchases will be guaranteed a 
$49.99 upgrade to the soon to be released, 
scriptable, MacWireFrame 5.0. 


Marksman by ITmaker graphically creates 
program's user interface: $125.00 


McCLint™ Rev. 2.2 by MMCAD. McCLint locates 
questionable C programming constructs, saving you 
hours by identifying programming mistakes and 
latent programming bugs. Some of the checks 
include variable type usage, conditional and 
assignment statement usage, arithmetic operations in 


conditional expressions, misplaced semicolons, 


pointer type coercion, function argument passing 
(with and without function prototypes), local and 
global variable initialization and usage, and 
existence/shape of return statements. McCLint 
includes a THINK C like, multiple window editor and 
source code highlighting system in a fully intergrated 
environment. One or more files can be analyzed in 
an interactive or batch fashion. Works with THINK C 
(including OOPS), MPW C.,... $149.95 


McCPrint™ Rev 2.2 by MMCAD. McCPrint reformats 
and beautifies C and C++ source code in a user 
specified manner. You can transform code to and 
from your programming style, making source code 
easier to read and work with. In addition to code 
formatting, documentation support aids include source 
code pagination, line number inclusion and control 
flow graphing. McCPrint includes a multiple window 





editor and source code highlighting system in a fully 
intergrated environment. Works with THINK C, MPW 
C/C++, supports System 7 and 32 bit addressing for 
use on any system including the Quadras. $99.95 


p1 Modula-2 V5.1 is a full implementation 

of the ISO Standard for Modula-2 which 
includes exception handling, termination, complex 
numbers, value constructors, a standard library and 
more. In addition it supports objects and MacApp, 
foreign language calls, all current MPW interfaces, 
optimized 680x0 instructions, three floating point types 
with four modes of operation, etc. A symbolic window 
debugger, several utilities and a set of examples 
(including MacApp tutorial) are included. p1 Modula-2 
requires MPW. It is targeted for professional 
development and prompt technical support by email or 
FAX is granted. $395, corporate 5 pack $1175. 


PictureCDEF by Paradigm Software is a 
professional-level CDEF for creating 
custom "puffy" graphical buttons (8-64 
pixels in size). PictureCDEF is multi- 
monitor and bit-depth sensitive. The button graphic 
(created with ResEdit) can be changed at runtime 
and even animated with a call-back routine. Create 
distinct buttons in six variations: PushButton, 
FlexiButton, ToggleButton, ChkButton, 
PushPictButton and TogglePictButton. Position the 
optional button title at left, bottom or right, or follow 
the system text direction for international support. 
25 button frames, manual and sample code 
included. MacApp 3.0 support. Demo available on 
Per) tequest. Full source code: $8506 
i $95.00. Object code: $85-06 $45.00. 


Qd3d/3dPane/SmartPane source code bundle by 
Vivistar Consulting. Qd3d 2.0: Full featured 3d 
graphics. Points; lines; polygons; polyhedra; 
Gouraud shading; z-buffering; culling; depth cueing; 
parallel, perspective, and sterioscopic projections: 
performance enhancing “OnlyQD” and “Wireframe’” 
modes; full clipping; pipeline access; animation and 
model interaction support; and a “triad mouse” to 
map 2d mouse movement to 3d. 3dPane 2.0: 
Integrates Qd3d with the TCL and provides a view 
orientation controller. SmartPane: Offscreen 
image buffering, flicker free animation, and 
QuickTime movie recording. For use with 
Qd3d/3dPane or in 2d settings. All work with C++ 
compilers or ThinkC 6. $192 


QUED/M 2.6 by Nisus is the text editor that has 
become the industry standard for speed and 
efficiency. This 32-bit clean version fully supports 
the MPW ToolServer through Apple Events, and the 
CODE module feature allows you to implement 
external source code as a menu command. In 
addition, QUED/M’s macro facility lets you create 
customized menu commands. We've even improved 
our acclaimed Find and Replace feature which can 
search unopened files for literal text or regular 
expressions created with GREP metacharacters. New 
features include a file comparison option which 
combines two or three files into one and marks 
conflicts automatically. $149 
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acintosh Drag And Drop continued from page 67 









comments, so here are some quick observations about working 
with text. 

There is a little more work to be done when adding 
support in a text editor. When the user is dragging in an editor 
window you need to provide visual feedback by showing the 
insertion point if the text was dropped at the location. This is 
simple, but takes a little code. You have to find the offset in the 
text where the user is dragging over, find the nearest character 
break, and then draw an appropriate sized caret. 

You can also add nice touches in the text editor by 
supporting what I call “smart spaces”. Basically if the user 
selects a word and drags it somewhere else, you will be left 
with two spaces where the word 
was. It’s cool to remove one of 
the spaces. Correspondingly, 
when the user drops the text, 
make sure you add a space if 
they are dropping the text at the 
end of another word. 

Building the drag outline for 
the selected text is easy if you are using TextEdit, thanks to a 
new feature of TextEdit that will provide you with a region of 
the selected text. There is a Gestalt function to determine if this 
feature is available. 





define gestaltTEAttr ‘teat’ 


The Gestalt function returns information by setting the 
following bit if this feature is available: 





66 Here’s a technology that even small 
developers can use to level the playing 
field against the corporate giants... 


define gestaltTEHasGetHiliteRgn 0 


This new feature of TextEdit was introduced with the Drag 
Manager and is very useful in building your drag region. 

Working with text is a bit more “interesting” than some 
other data types, but the sample code that Apple put together 
really shows you what you need to know to go right to it. 


CONCLUSIONS 


We've covered what the Drag Manager is and shown you a 
little about how to use it. Now it’s your turn to go prove to 
yourself that it’s not only easy to implement in your 
applications, almost nothing gives you more bang for the buck 
when you’re demo’ing your software to a prospective client. 
Drag and Drop seems to be the 
second-most-liked feature of the 
programs when they’re demo’ed 
(first-most-liked usually goes to 
the reason the program was 
written in the first place). Here's 
a technology that even small 
developers can use to level the 
playing field against the corporate giants (as opposed to 
technologies which require multi-million dollar investments to 
exploit and don’t even phase the corporate big boys). 

Overall, the API is extremely clean, and we’re looking 
forward to a new, even better version some time this year in 
System 7.5. 

[Let us know how your experience goes with adding Drag 
and Drop to your software at editorial@xplain.com — ed stb/ 


wv 


am, 








Mail Order Store cont'd from page 76 


QuickControl™ by Faceware supports QuickTime 
animation in ViewIt™ windows, including movie 
creation, editing, playing, compression, and file 
handling. Requires ViewIt. $75 


ScriptGen Pro™ by Stepup Software is an Installer 
script generator which requires no programming or 
knowledge of Rez. Supports StepUp's InstallerPack, 
Stuffit compression, custom packages, splash 
screens, network installs, Rez code output, 
importing resources, and AE link w/MPW: $169 


ScriptIt™ by Faceware library supports editing 
and execution of AppleScript scripts from within 
other programs. Also extends AppleScript to 
provide access to program records, callback 
routines and other modules. $95 


SoftPolish by Language Systems is a development 
tool that helps software developers avoid 
embarrassing spelling errors, detect incorrect or 
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incompatible resources and improve the appearance 
of their Macintosh software. SoftPolish examines 
application resources and reports potential problems 
to a scrolling log. Independent of any programming 
language or environment, SoftPolish improves the 
quality of any Macintosh program. $169 


StoneTable by Stone Tablet Publishing: a library 
replacing all funtions found in list manager plus: 
variable size columns/rows; different font, size, stule, 
forecolor, backcolor per cell; sort, resize, move, 
copy, hide columns/rows; edit cells/titles in place; 
titles for columns/rows; multiple lines per cell; grid 
line pattern/color; greater than 32k data per table; 
up to 32k text per cell; support for balloon help and 
binary cell data. Versions for THINK C, THINK 
Pascal, MPW C, MPW Pascal. (all prices per 
developer) $150, any 2 compilers $200, any 3 
compilers $250, all 4 compilers $300. 


Stone Table Extra: additional functions 
for StoneTable. Drag selected cells 


within table or to other tables; optionally add rows as 
part of drag; popup menus in cells; variable width grid 
lines; move/drag/resize table in window; clipboard 
operations on multiple cells. Requires StoneTable. (all 
prices per developer) $50, any 2 compilers $75, any 3 
compilers $100, all 4 compilers $150. 


ViewlIt™ by Faceware library is an advanced 
window designer and manager that overcomes 
Dialog Manager limitations. Includes support for 
on-line editing, view hierarchy, direct links to 
program variables, multiple fonts/styles/colors and 
complete set of custom controls. $95.00 


ViperBase by Viper Development is a fast 

database designed for developers that want 
speed but don't want to spend months or years 
developing a commercial quality database. ViperBase: 
Unlimited Records, Variable Length. $59.00. 
ViperBase II: ViperBase + Multiple Indices. $119.00 


o 
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Tips & Tidbits continued from page 80 


careful how you apply them, and please don’t perform surgery 
on your only copy of any file! 
— Lee David Rimar, Absoft Corporation 


RUSE SSE ES ES SSE A A SSE SPSS ESS SE A SATA 
EVER HEARD OF SETKEY? 


I’m just amazed at some of the SmartFriends™ I know who 
haven’t heard of SetKey, an MPW command that has been 
around for quite some time. It just goes to show how few 
people read release notes or manuals for MPW. Maybe it’s just 
that these people all worked at Apple, where coming by 
production versions of manuals can be enough of a chore that 
it’s not worth the trouble. 

At any rate, SetKey lets you attach a script to any key or 
key combination on your keyboard, even the function keys on 
the extended keyboard. So tip #1 is to try out SetKey. SetKey 
uses the following syntax: 


SetKey <empty> | -r | [modifierkey-]..key[-modifierkey-]..key] [string] 
modifierkey = command | option | shift | control 
-r if revert to the default key assignments 


Tip #2 is to enter SetKey in a shell window, and see what’s 
already set. You might be surprised at some of the things MPW 
already knows how to do with key combinations. 

Function keys are F1-F15. Other keys are referenced by 
name, such as the following: 


setkey Option-Command-Downarrow MoveEndOfFile 
setkey Option-Command-Uparrow MoveStartOfFile 
setkey Option-Shift-Delete Beep 

setkey Option-Shift-Escape Beep 

setkey Option-Shift-Clear "Clear § “active; 
setkey Option-Shift-Del Beep 


setkey Option-Shift-Leftarrow SelectWordLeft 


For Tip #3 and following, here are some scripts I use a lot: 


e To mark the current selection in the active window, I use 
function key F8. 


# mark current selection in the Active window 
setkey F8 'Mark § "‘Catenate "{Active}".§*" "{Active}"™ -y' 


e Here’s a fun one. It sorts the current selection. 


# sort the current selection in the Active window 
SetKey Fl2 'sort -o "{SysTempFolder}MPW.Scratch" d 
"{Active}".§ ; a 
catenate "{SysTempFolder}MPW.Scratch" > "{Active}".§ : 9 
delete "{SysTempFolder}MPW.Scratch"' 


¢ Finally, here are three simple scripts I use frequently. I add 
them to a new menu, and I give that menu the cloverleaf 
character from the command key as a title. The first line 
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sets a variable to have the value of the cloverleaf character. 
Where you see the cloverleaf below, you'll probably see a I 
character when you type control-Q. 


Set Key 3%  #cloverleaf=ctl-Q 


This one compiles the current selection, then dumps the object 
code that the C compiler generated. 


AddMenu {Key} 'C->DumpObj §' 'C "{Active}.§" -mc68020 -mbg a 
off -o "{SysTempFolder}temp.c.o"; 0 
DumpObj "{SysTempFolder}temp.c.o" -co' 


This one assembles the current selection, then dumps the 
resulting object code. 


AddMenu {Key} 'Asm->DumpObj §' ‘Asm "{Active}.§" 9 
-o "{SysTempFolder}temp.c.o"; d 
DumpObj "{SysTempFolder}temp.c.o" -co! 


This one compares the current selection in the active window to 
the selection in the target window. 


AddMenu {Key} 'Compare {Active}.§ §' @ 
‘Compare "{Active}.§" "{Target}.§" >> "{Worksheet}"' 


- Gordon Sheridan, General Magic 


SS SSS SS 
ASSEMBLING KAHRS 


When putting together a Kahrs wood plank floor, go ahead 
and shell out the thirty dollars or so for the “pull-up” tool. It’s 
not entirely obvious why you’d need it when you first start 
putting the floor together, although it looks like it might be 
handy to cinch up planks once you have the whole row down. 
It turns out not to help for that (the friction is simply too great 
along the length of the plank), but it does wonders when you 
start laying the last couple of rows. Up to that point, you can 
just use a tap-block and a mallet to tighten the new plank 
against the previous row. Once you get close to the far wall, 
though, there’s no room to swing the mallet, much less place 
the tap-block. The pull-up tool fits into the groove which is 
right against the wall, and gives you some room to swing the 
mallet, and pull the board into place. 


— Al Borland, Chicago, IL 


[Thanks for the tip, Al. It’s definitely better than putting a hole in 
the drywall with a prybar. You might want to send this tip to 
HomeTech Magazine as well — I understand they give away a 


free can of putty!. — Ed kag] 2 
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SLIMMING DOWN “FAT BINARIES” WITH MPW — 

Fat binaries contain both Macintosh 68K and PowerPC 
code, so they can run on any Mac hardware and take 
advantage of whatever processor is present. 

A fat binary contains 68K executable 'CODE' resources 
and other standard Mac resources in the resource fork, and 
PowerPC Executable Format (PEF) code in the data fork. It 
also includes a 'cfrg' resource, to tell a Power Mac to ignore 
CODE resources at startup and look for PEF code in the data 
fork. A 68K Mac ignores the 'cfrg' resource and PEF code, 
using the 'CODE' resources instead. 

This is fine for developers who only want to ship only 
one version of their product, and for users who want to be 
able to just click and go on any system, even when file- 
sharing across a network mixed with 68K and Power Macs. 
But lone power users with limited disk space may wish to 
perform liposuction on fat binaries, and MPW makes it easy. 
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To convert a fat binary to a “68K only’application: 


## MPW Script "To68K" 


Tt l= 1 
Echo "# Usage: {0} fat_application_name" 
Else 
Derez -skip cire “i1/" | Kez -o “{1)" # eliminate ‘cig’ resource 
Duplicate -y cr “{1)" 711) temp” # eliminate data fork 
Rename -y "{1}.temp” "{1}" # replace original file 
End 


To convert a fat binary into a “Power Mac only” application: 


# MPW Script "ToPowerMac" 


it (oa 

Echo "# Usage: {0} fat_application_name" 
Else 

Derez -skip CODE "{1}" | Rez -o "{1}" # eliminate 'CODE' resources 
End 


Caveats: Neither of these scripts check if they are really 
operating on a fat binary, nor do they know whether a native 
version might need one or more CODE segments, so be 


Continued on page 78 
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“The definitive database engine 
for the Macintosh. Inside Out’s speed 
| ts particularly impressive.” 


David Thompson 
Director of Software Development 
Sybase DEFT Division 
_ The 
database 
powerhouse 


behind corporate and 
commercial 3GL development. 


Sybase: DEFT® 
Ensign Systems: POSeIM™ 
Aldus Corporation: FETCH® 
WestWare: CONTACT EASE™ 
Multi-Ad Services, Inc.; SEARCH 

Blueridge Technologies, Inc.: OPTIX™ 
Apple Computer, Inc.: APPLE ORDER 
Philip Morris: Sales Automation System 
US Air Force: Office Automation Systems 
Robins Analytics: READY FOR TRIAL!® 





Ernst and Young: Audit Automation System SIER 
State of the Art Inc: ACCOUNTANT, INC. Eddy Award Winner Ro ks S 
HealthCare Communications: Medical Office Management Systems 
923 Tahoe Blvd. 
Applications developed and distributed with Inside Out te ite 
have an annual value in excess of $100 million dollars. Phone: 702.832.0300 
Fax: 792,832.7753 


AppleLink: D2086 


